统一接口返回结构

[TonyTown6033]

描述

为所有接口引入统一的返回结构，提升接口一致性和可维护性。

返回示例

{
  "code": 0,
  "message": "success",
  "data": {}
}

任务拆分

• 定义统一的 Response / Result 返回类
• Controller 层统一使用该返回结构
• 约定通用成功码和错误码

验收标准

• 所有接口返回结构保持一致
• 错误响应包含明确的 code 和 message

[TonyTown6033]

@alonelily 关于之前说的统一接口的事情 看这个issue

[TonyTown6033]

• 统一返回结构建议这样设计（简洁且可扩展）：

结构

{
"code": 0,
"message": "success",
"data": {}
}

Java 定义

public record ApiResponse(int code, String message, T data) {
public static ApiResponse ok(T data) {
return new ApiResponse<>(0, "success", data);
}
public static ApiResponse error(int code, String message) {
return new ApiResponse<>(code, message, null);
}
}

统一错误码建议

• 0：success
• 40001：参数错误
• 40004：资源不存在
• 40101：未授权
• 50000：系统异常

落地方式

• Controller 全部返回 ApiResponse
• GlobalExceptionHandler 统一转换异常为 ApiResponse.error(...)

[alonelily]

支持