用户注册场景下向用户返回错误描述的最佳实现方案

哈哈，这个问题我做用户注册功能的时候也纠结过！返回清晰的失败原因确实是业务Service层的常见痛点，尤其是要给前端精准提示的时候。结合你的业务规则（邮箱唯一、姓名非空），我给你分享几个实际项目里常用的解决方案，你可以根据自己的架构偏好选：

其实你一开始想到的RegistrationResult思路是对的，可能之前没把它设计得足够完善。我们可以给结果对象加上标准化的错误枚举，把所有可能的失败原因提前定义好，这样不管是Service内部还是上层调用者，都能清晰识别错误类型。

代码示例：

// 先定义注册错误的枚举，把业务规则对应的失败原因标准化
public enum RegistrationError {
    EMAIL_DUPLICATE("邮箱已被注册"),
    NAME_EMPTY("姓名不能为空"),
    SYSTEM_ERROR("系统异常，请稍后重试");

    private final String message;

    RegistrationError(String message) {
        this.message = message;
    }

    public String getMessage() {
        return message;
    }
}

// 注册结果对象，包含成功状态、错误信息、成功时的用户数据
public class RegistrationResult {
    private boolean success;
    private RegistrationError error;
    private User user; // 成功时返回用户信息

    // 用静态工厂方法创建结果，更直观
    public static RegistrationResult success(User user) {
        RegistrationResult result = new RegistrationResult();
        result.success = true;
        result.user = user;
        return result;
    }

    public static RegistrationResult failure(RegistrationError error) {
        RegistrationResult result = new RegistrationResult();
        result.success = false;
        result.error = error;
        return result;
    }

    // 省略getter/setter
}

// Service实现类
public class RegistrationServiceImpl implements RegistrationService {
    private UserRepository userRepository;

    @Override
    public RegistrationResult register(String email, String name) {
        // 校验姓名非空
        if (name == null || name.trim().isEmpty()) {
            return RegistrationResult.failure(RegistrationError.NAME_EMPTY);
        }
        // 校验邮箱唯一性
        if (userRepository.existsByEmail(email)) {
            return RegistrationResult.failure(RegistrationError.EMAIL_DUPLICATE);
        }
        // 执行注册逻辑
        User user = new User(email, name);
        userRepository.save(user);
        return RegistrationResult.success(user);
    }
}

这个方案的优点：

• 类型安全，错误原因不会出现拼写错误或者语义模糊的情况
• 上层调用者（比如Controller）可以直接根据error枚举给前端返回对应的提示，非常清晰
• 避免用异常控制业务流程，符合“异常用于意外错误”的设计原则

如果你的系统习惯用异常来处理业务级别的错误，而且上层有统一的异常捕获机制（比如全局异常处理器），那可以定义专门的注册异常类，把不同的失败原因封装成不同的异常（或者用一个异常带错误码）。

代码示例：

// 自定义注册业务异常基类
public class RegistrationException extends RuntimeException {
    private final String errorCode;

    public RegistrationException(String errorCode, String message) {
        super(message);
        this.errorCode = errorCode;
    }

    public String getErrorCode() {
        return errorCode;
    }
}

// 具体的异常子类（也可以不用子类，直接传枚举code）
public class EmailDuplicateException extends RegistrationException {
    public EmailDuplicateException() {
        super("EMAIL_DUPLICATE", "邮箱已被注册");
    }
}

public class NameEmptyException extends RegistrationException {
    public NameEmptyException() {
        super("NAME_EMPTY", "姓名不能为空");
    }
}

// Service实现类
public class RegistrationServiceImpl implements RegistrationService {
    private UserRepository userRepository;

    @Override
    public User register(String email, String name) throws RegistrationException {
        if (name == null || name.trim().isEmpty()) {
            throw new NameEmptyException();
        }
        if (userRepository.existsByEmail(email)) {
            throw new EmailDuplicateException();
        }
        User user = new User(email, name);
        userRepository.save(user);
        return user;
    }
}

这个方案的优点是代码更简洁，不需要每次构建结果对象；但要注意：业务预期内的错误用异常，可能违反异常的设计初衷，而且如果后续失败原因增加，会产生很多异常子类，维护成本上升。

如果不想定义太多类，也可以用Pair<Optional<User>, String>这种轻量结构，成功时返回用户和空字符串，失败时返回空和错误信息。但这种方式没有类型安全保障，错误信息容易出现不一致的情况，只适合小型项目或者临时场景。

内容的提问来源于stack exchange，提问作者anoam