Spring Boot项目登录失败问题排查与解决请求

从控制台日志[nio-8787-exec-6] o.h.type.descriptor.sql.BasicBinder : binding parameter [1] as [VARCHAR] - []可以明确：登录请求的参数未成功绑定到SQL查询中，导致数据库查询不到匹配的用户，最终返回"Invalid username or password"错误。以下是针对性的排查和修复步骤：

1. 检查前端表单参数名一致性 #

核心问题：前端表单的输入字段name属性必须与后端接收的参数名完全匹配，否则参数无法传递。

修正后的UserLogin.html表单示例 #

<form action="/login" method="post">
    <div>
        <label>用户名:</label>
        <!-- 确保name属性为"username"，与后端参数名一致 -->
        <input type="text" name="username" required>
    </div>
    <div>
        <label>密码:</label>
        <!-- 确保name属性为"password"，与后端参数名一致 -->
        <input type="password" name="password" required>
    </div>
    <button type="submit">登录</button>
</form>

2. 修复UserRepository的查询逻辑 #

确保Repository的查询方法能正确接收并绑定参数，与实体类字段名匹配。

修正后的UserRepository.java示例 #

import org.springframework.data.jpa.repository.JpaRepository;
import org.springframework.stereotype.Repository;
import com.yourpackage.model.User;

@Repository
public interface UserRepository extends JpaRepository<User, Long> {
    // 方法命名需严格对应实体类的字段名（如username、password）
    User findByUsernameAndPassword(String username, String password);

    // 若使用@Query注解，需确保参数占位符与方法参数对应
    // @Query("SELECT u FROM User u WHERE u.username = :username AND u.password = :password")
    // User findByCredentials(@Param("username") String username, @Param("password") String password);
}

3. 确保控制器参数接收正确 #

控制器需正确接收前端传递的参数，避免参数绑定为空。

修正后的登录控制器示例 #

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestParam;
import com.yourpackage.repository.UserRepository;
import com.yourpackage.model.User;

@Controller
public class LoginController {

    @Autowired
    private UserRepository userRepository;

    // 使用@RequestParam明确绑定前端参数，确保参数名完全匹配
    @PostMapping("/login")
    public String login(@RequestParam("username") String username, 
                       @RequestParam("password") String password) {
        User user = userRepository.findByUsernameAndPassword(username, password);
        if (user != null) {
            // 登录成功，跳转至GuestHome.html
            return "redirect:/GuestHome";
        } else {
            // 登录失败，返回登录页并提示错误
            return "UserLogin?error";
        }
    }
}

4. 额外注意：密码加密校验（若涉及） #

如果注册时对密码进行了加密存储（如使用BCryptPasswordEncoder），登录时需用相同加密方式比对，而非直接明文匹配：

// 注入密码加密器
@Autowired
private BCryptPasswordEncoder passwordEncoder;

// 登录方法中修改校验逻辑
if (user != null && passwordEncoder.matches(password, user.getPassword())) {
    return "redirect:/GuestHome";
}

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