public enum ResultCode {
    // 成功狀態(tài)
    SUCCESS(200, "操作成功"),
    // 客戶端錯誤
    PARAM_ERROR(400, "參數(shù)格式錯誤"),
    AUTH_FAILED(401, "認(rèn)證失敗"),
    // 服務(wù)端錯誤
    SYSTEM_ERROR(500, "系統(tǒng)異常");
    private final int code;
    private final String message;
    // 構(gòu)造方法、getter 略
}

import lombok.AllArgsConstructor;
import lombok.Getter;
@Getter
@AllArgsConstructor
public enum ResultCode {
    // 成功
    SUCCESS(200, "操作成功"),
    // 客戶端錯誤
    PARAM_ERROR(400, "參數(shù)格式錯誤"),
    AUTH_FAILED(401, "認(rèn)證失敗"),
    FORBIDDEN(403, "沒有權(quán)限"),
    NOT_FOUND(404, "資源不存在"),
    // 服務(wù)端錯誤
    SYSTEM_ERROR(500, "系統(tǒng)異常"),
    REMOTE_CALL_FAILED(501, "遠(yuǎn)程調(diào)用失敗");
    private final int code;
    private final String message;
}

import lombok.Data;
import java.time.Instant;
@Data
public class R<T> {
    private int code;
    private String message;
    private T data;
    private long timestamp;
    // 私有構(gòu)造，避免直接 new
    private R(int code, String message, T data) {
        this.code = code;
        this.message = message;
        this.data = data;
        this.timestamp = Instant.now().toEpochMilli(); // 自動填充時間戳
    }
    // 成功響應(yīng)：無數(shù)據(jù)
    public static <T> R<T> success() {
        return new R<>(ResultCode.SUCCESS.getCode(), ResultCode.SUCCESS.getMessage(), null);
    }
    // 成功響應(yīng)：帶數(shù)據(jù)
    public static <T> R<T> success(T data) {
        return new R<>(ResultCode.SUCCESS.getCode(), ResultCode.SUCCESS.getMessage(), data);
    }
    // 錯誤響應(yīng)：使用枚舉定義的狀態(tài)
    public static <T> R<T> error(ResultCode code) {
        return new R<>(code.getCode(), code.getMessage(), null);
    }
    // 錯誤響應(yīng)：自定義狀態(tài)碼和消息
    public static <T> R<T> error(int code, String message) {
        return new R<>(code, message, null);
    }
}

import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.RestControllerAdvice;
@RestControllerAdvice
public class GlobalExceptionHandler {
    // 處理自定義業(yè)務(wù)異常（假設(shè)定義了 BusinessException）
    @ExceptionHandler(BusinessException.class)
    public R<Void> handleBusinessException(BusinessException e) {
        // 業(yè)務(wù)異常通常攜帶具體錯誤碼和消息
        return R.error(e.getCode(), e.getMessage());
    }
    // 處理參數(shù)綁定異常（如 @RequestParam 格式錯誤）
    @ExceptionHandler(IllegalArgumentException.class)
    public R<Void> handleIllegalArgument(IllegalArgumentException e) {
        return R.error(ResultCode.PARAM_ERROR.getCode(), e.getMessage());
    }
    // 處理所有未捕獲的異常（兜底）
    @ExceptionHandler(Exception.class)
    public R<Void> handleException(Exception e) {
        // 生產(chǎn)環(huán)境可記錄日志，此處簡化
        return R.error(ResultCode.SYSTEM_ERROR);
    }
}

import lombok.Data;
import java.util.List;
@Data
public class PageResult<T> {
    private long total; // 總條數(shù)
    private int pageNum; // 當(dāng)前頁
    private int pageSize; // 每頁大小
    private List<T> list; // 數(shù)據(jù)列表
    // 構(gòu)造方法略
}

PageResult<User> pageResult = new PageResult<>(total, pageNum, pageSize, userList);
return R.success(pageResult);

import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;
@RestController
public class UserController {
    @GetMapping("/user")
    public R<User> getUser(@RequestParam Long id) {
        if (id == null || id <= 0) {
            // 參數(shù)錯誤，返回錯誤響應(yīng)
            return R.error(ResultCode.PARAM_ERROR);
        }
        User user = userService.getUserById(id); // 假設(shè)從服務(wù)層獲取用戶
        if (user == null) {
            // 資源不存在，返回自定義消息
            return R.error(ResultCode.NOT_FOUND.getCode(), "用戶不存在");
        }
        // 成功返回數(shù)據(jù)
        return R.success(user);
    }
}

// 成功帶數(shù)據(jù)
{
  "code": 200,
  "message": "操作成功",
  "data": { "id": 1, "name": "張三" },
  "timestamp": 1711234567890
}
// 失敗
{
  "code": 404,
  "message": "用戶不存在",
  "data": null,
  "timestamp": 1711234567900
}