推荐使用自定义LoginFailureException异常类配合业务分层与全局异常处理器统一处理登录失败：Service层按原因抛出带错误码的异常，@ControllerAdvice捕获并返回标准JSON响应，可选枚举管理错误码提升可维护性。

在 Java 中，封装用户登录失败的错误，推荐通过自定义异常类 + 业务逻辑分层（如 Controller → Service）协同处理，让错误语义清晰、可捕获、可统一响应。

定义登录专用异常类

创建一个继承 RuntimeException 的自定义异常（运行时异常，无需强制 try-catch），明确表达“登录失败”语义：

public class LoginFailureException extends RuntimeException {
    private final String errorCode; // 如 "USER_NOT_FOUND", "PASSWORD_WRONG", "ACCOUNT_LOCKED"

    public LoginFailureException(String message) {
        this(message, null, "UNKNOWN_ERROR");
    }

    public LoginFailureException(String message, String errorCode) {
        this(message, null, errorCode);
    }

    public LoginFailureException(String message, Throwable cause, String errorCode) {
        super(message, cause);
        this.errorCode = errorCode;
    }

    public String getErrorCode() {
        return errorCode;
    }
}

这样设计支持携带结构化错误码，便于前端区分处理（比如跳转不同提示页或触发重置流程）。

在 Service 层抛出具体登录异常

登录逻辑中，根据失败原因抛出带语义的异常，而不是返回 null 或通用错误码：

• 用户名不存在 → throw new LoginFailureException("用户不存在", "USER_NOT_FOUND");
• 密码错误 → throw new LoginFailureException("密码错误", "PASSWORD_WRONG");
• 账号被锁定 → throw new LoginFailureException("账号已被锁定，请联系管理员", "ACCOUNT_LOCKED");

Service 方法保持专注：只做校验和业务判断，不处理 HTTP 响应，也不打印日志（交由全局异常处理器统一处理）。

Java Api Extractor

从 Java 项目中提取 Controller 层接口定义为 JSON 数据。

下载

全局异常处理器统一响应格式

使用 @ControllerAdvice 捕获 LoginFailureException，返回标准 JSON 错误结构：

@RestControllerAdvice
public class GlobalExceptionHandler {

    @ExceptionHandler(LoginFailureException.class)
    public ResponseEntity<apiresponse> handleLoginFailure(LoginFailureException e) {
        ApiResponse response = ApiResponse.fail(e.getMessage())
            .withCode(e.getErrorCode())
            .withTimestamp(System.currentTimeMillis());
        return ResponseEntity.status(HttpStatus.UNAUTHORIZED).body(response);
    }
}
</apiresponse>

其中 ApiResponse 是你项目约定的统一响应体（含 code、message、data、timestamp 等字段），确保前端始终收到可解析的错误结构。

可选：配合枚举增强可维护性

把错误码和默认消息抽成枚举，避免硬编码字符串：

public enum LoginError {
    USER_NOT_FOUND("USER_NOT_FOUND", "用户不存在"),
    PASSWORD_WRONG("PASSWORD_WRONG", "密码错误"),
    ACCOUNT_LOCKED("ACCOUNT_LOCKED", "账号已被锁定");

    private final String code;
    private final String defaultMessage;

    LoginError(String code, String defaultMessage) {
        this.code = code;
        this.defaultMessage = defaultMessage;
    }

    public String getCode() { return code; }
    public String getDefaultMessage() { return defaultMessage; }
}

Service 中即可写：throw new LoginFailureException(err.getDefaultMessage(), err.getCode());，后续增删类型更安全。

Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南