客户端与服务端Bcrypt哈希密码不匹配问题求助

API 探路者

2026-7-18

问题描述

我有两个需要交互的项目：Android客户端和Spring Boot服务端，二者均使用BCrypt作为哈希编码器。注册时，Android客户端对用户密码哈希后传输给服务端存储；登录时，客户端再次对同一原始密码哈希后传给服务端，却发现两次生成的哈希值不一致（例如密码password1注册时哈希为$2a$10$FgIbXCXzYrpwcKV8bS2BoulXDDBvwywXKB5MMyiUkQzDk66zTFli6，登录时为$2a$10$J33C5WCT0zRh/P17R6soMupgQmkIh6JD9bPKPi4kUJhjGWnv0R6OW），导致服务端无法匹配。我猜测这与盐有关，但不清楚如何在客户端提取盐并在服务端用于密码对比。

客户端相关代码如下：

注册时哈希密码的代码

...
        password = passwordEncoder().encode(password)

        apiService.addCustomer(
            ApiCustomer(
                username = username,
                password = password,
                dob = LocalDate.parse(convertDOB(dob)).toString(),
                firstName = firstName,
                lastName = lastName,
                isActive = true,
                email = email,
                mobileNumber = mobileNumber,
            )
        )
...

PasswordEncoder初始化代码

fun passwordEncoder(): PasswordEncoder = BCryptPasswordEncoder()

问题原因

BCrypt的核心特性就是每次哈希都会自动生成随机盐，并且会把盐嵌入到最终生成的哈希字符串里（比如你看到的哈希值前半段$2a$10$FgIbXCXzYrpwcKV8bS2Bou，就包含了算法版本、工作因子和随机盐）。所以同一原始密码每次调用encode()都会生成不同的哈希值，这是正常现象，但也直接导致你的登录逻辑失效——客户端两次哈希结果不一样，服务端根本没法匹配。

而且你搞反了逻辑：BCrypt设计时就不需要手动提取或传递盐，服务端只需要用存储的哈希值验证原始密码就行，完全不需要客户端提前哈希密码。

正确解决方案

核心原则：别在客户端哈希密码，直接传原始密码（必须用HTTPS加密传输），哈希存储和验证全交给服务端处理。

1. 客户端修改

删掉客户端的密码哈希逻辑，直接把用户输入的原始密码传给服务端：

// 删除这行：password = passwordEncoder().encode(password)
apiService.addCustomer(
    ApiCustomer(
        username = username,
        password = password, // 直接传原始密码
        dob = LocalDate.parse(convertDOB(dob)).toString(),
        firstName = firstName,
        lastName = lastName,
        isActive = true,
        email = email,
        mobileNumber = mobileNumber,
    )
)

同时可以删掉客户端的passwordEncoder()方法，没用了。

2. 服务端处理

注册阶段：接收客户端传来的原始密码，用BCrypt哈希后再存到数据库。
登录阶段：接收原始密码，从数据库取出对应用户的哈希值，调用BCrypt的matches()方法验证——这个方法会自动从存储的哈希值里提取盐，用相同规则重新哈希原始密码，再和存储的哈希值对比。

服务端示例代码（Spring Boot）：

// 注册接口
@PostMapping("/register")
public ResponseEntity<?> register(@RequestBody CustomerDTO customerDTO) {
    // 哈希原始密码
    String hashedPassword = passwordEncoder.encode(customerDTO.getPassword());
    customerDTO.setPassword(hashedPassword);
    // 保存到数据库
    customerRepository.save(customerDTO);
    return ResponseEntity.ok("注册成功");
}

// 登录接口
@PostMapping("/login")
public ResponseEntity<?> login(@RequestBody LoginDTO loginDTO) {
    Customer customer = customerRepository.findByUsername(loginDTO.getUsername());
    // 验证密码：matches(原始密码, 存储的哈希值)
    if (customer == null || !passwordEncoder.matches(loginDTO.getPassword(), customer.getPassword())) {
        return ResponseEntity.badRequest().body("用户名或密码错误");
    }
    // 后续生成登录token等操作
    return ResponseEntity.ok("登录成功");
}

// 配置BCrypt密码编码器
@Bean
public PasswordEncoder passwordEncoder() {
    return new BCryptPasswordEncoder();
}

为什么不推荐客户端哈希？

如果硬要在客户端哈希，你得：

客户端哈希时手动生成固定盐，还要把盐和哈希值一起传给服务端存起来；
登录时客户端得先从服务端拿到该用户的盐，用同样的盐哈希密码后再传给服务端对比。

但这种做法完全违背BCrypt的设计初衷，徒增复杂度，还可能带来额外安全风险（比如盐的传输存储不当）。而且只要用HTTPS传输原始密码，安全性和客户端哈希完全一样，还更简单可靠。

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

客户端与服务端Bcrypt哈希密码不匹配问题求助

注册时哈希密码的代码 #

PasswordEncoder初始化代码 #

核心原则：别在客户端哈希密码，直接传原始密码（必须用HTTPS加密传输），哈希存储和验证全交给服务端处理。 #