Spring+JWT实现多方式（用户名/手机号/邮箱）可选登录遇阻求助

首先，你的代码存在语法错误和逻辑问题，这是导致功能无法运行的核心原因。UserDetailsService是一个单方法接口，你必须实现唯一的loadUserByUsername方法，不能像你那样用if/else包裹多个方法定义——这不符合Java语法规范。另外，你的逻辑里不管是手机号还是邮箱，都调用了findByUsername，这显然无法正确匹配手机号或邮箱对应的用户。

下面是修正后的完整实现方案：

1. 确保UserRepository有对应的查询方法 #

首先，你的UserRepository需要提供根据用户名、手机号、邮箱查询用户的方法：

public interface UserRepository extends JpaRepository<User, Long> {
    Optional<User> findByUsername(String username);
    Optional<User> findByPhone(String phone);
    Optional<User> findByEmail(String email);
}

这里用Optional来避免空指针，比直接返回null更安全。

2. 正确实现MyUserDetailsService #

我们在单一的loadUserByUsername方法里，依次尝试用传入的参数匹配用户名、手机号、邮箱：

@Service
public class MyUserDetailsService implements UserDetailsService {

    private final UserRepository userRepository;

    // 构造注入（推荐替代@Autowired）
    public MyUserDetailsService(UserRepository userRepository) {
        this.userRepository = userRepository;
    }

    @Override
    public UserDetails loadUserByUsername(String credential) throws AuthenticationException {
        // 1. 先尝试按用户名查询
        User user = userRepository.findByUsername(credential)
                .orElse(null);
        
        // 2. 如果没找到，尝试按手机号查询
        if (user == null) {
            user = userRepository.findByPhone(credential)
                    .orElse(null);
        }
        
        // 3. 如果还没找到，尝试按邮箱查询
        if (user == null) {
            user = userRepository.findByEmail(credential)
                    .orElseThrow(() -> new UsernameNotFoundException(
                            "未找到与该凭证匹配的用户：" + credential));
        }

        return new MyUserPrincipal(user);
    }
}

3. 自定义异常的注意事项 #

如果你想使用自定义的PhoneNotFoundException或EmailNotFoundException，请确保这些异常继承自Spring Security的AuthenticationException（或其子类，比如UsernameNotFoundException）：

public class PhoneNotFoundException extends UsernameNotFoundException {
    public PhoneNotFoundException(String phone) {
        super("未找到手机号为" + phone + "的用户");
    }
}

这样Spring Security才能在认证流程中正确处理这些异常。

关键说明 #

• UserDetailsService的loadUserByUsername方法中的username参数其实可以是任意用户凭证（用户名、手机号、邮箱），只是方法名沿用了传统的命名，你可以在方法内部自行判断匹配逻辑。
• 使用Optional可以简化空值判断，让代码更简洁安全。
• 推荐使用构造注入替代@Autowired，这是Spring官方推荐的注入方式，更利于测试和依赖管理。

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