Java框架快速入门: Spring Security+OAuth2之密码存储安全进化与实践

纲要

• 密码的演变简史：从明文到多因子认证
• 密码存储安全进化：明文、哈希、加盐、自适应哈希
• Spring Security 对密码哈希的支持
  • PasswordEncoder 接口与主要实现
  • BCryptPasswordEncoder 深入解析
• 实战：在 Spring Security 中配置自适应密码编码器
• 代码示例：完整可运行的 Spring Boot 安全配置
• 总结

密码的演进：从简单到多因子

在计算机系统的早期，密码常以明文形式存储和传输，没有长度和复杂度限制。用户可以使用简单的一位或两位密码，应用性虽好，但极易遭受字典攻击或网络嗅探，安全性极低。

随后，系统开始强制密码长度和字符组合策略：必须包含字母、数字、特殊字符，并要求定期更换密码且不能与近期密码重复。这在一定程度上提升了安全性，但也给用户带来了记忆负担。

再往后，多因子认证（MFA）成为主流。用户在输入静态密码后，还需提供第二个因子（如短信验证码、硬件令牌、生物特征等），构成双因子或更多因子的登录流程。这种方式在安全性和用户体验之间取得了较好平衡。

近年来，无密码登录逐渐兴起，例如指纹识别、人脸识别和 FIDO2 等基于生物特征或设备绑定密钥的方案。这些方案在理论安全性上优于传统密码，因为验证的是用户本身而非一段可被猜测的文本。不过，受设备能力和统一标准限制，目前多数 Web 应用仍以传统的用户名密码结合多因子认证为主要选择。

密码存储安全：从明文到自适应哈希

对于服务端开发者而言，保障用户密码在存储时的安全性是核心责任之一。黑客攻击的性价比往往体现在"拖库"上：一旦攻破服务器并获取数据库，便可拿到所有用户的凭证信息。为应对这一威胁，密码存储经历了以下几个阶段。

明文存储

最初密码以明文直接存入数据库。数据泄露后，攻击者立即可用所有用户名和密码登录系统，几乎没有任何防护。

单向哈希

为防范拖库后明文泄露，开始对密码进行单向哈希处理。哈希算法（如 MD5、SHA-256）将密码映射为固定长度的摘要，且理论上不可逆推原文。但攻击者进化出"彩虹表"攻击：预先计算海量字符串的哈希值并存入大型映射表，获取到哈希后直接反查明文。

加盐哈希

为对抗彩虹表，引入"盐值"（Salt）概念。每次为密码生成哈希时，拼接一个随机生成的字符串，再计算哈希。即便两个用户使用相同密码，最终存储的哈希值也完全不同，使彩虹表攻击失效。盐值通常与哈希一同存储，无需保密，只需确保全局唯一且随机。

自适应哈希

随着硬件算力提升，攻击者可以快速计算大量哈希值用于暴力破解。自适应哈希的核心思想是：故意增加哈希计算的资源消耗，拖慢攻击速度。它具备两个关键特性：

• 可配置的迭代次数：通过多次迭代计算哈希（例如对结果反复应用哈希函数），显著延长单次哈希所需时间。迭代次数可随硬件发展动态调整。
• 内置随机盐值：自适应算法本身即包含盐值生成与管理，无需开发者额外处理。

常见的自适应算法有 bcrypt、scrypt 和 Argon2。它们通过工作因子（如 BCrypt 的 strength 参数）控制 CPU/内存消耗，使得验证登录虽然只多耗费几十毫秒，但对暴力攻击的吞吐量却能产生数量级的下滑。配合 IP 限制、账户锁定等策略，可以极大提升攻击成本。
#mermaid-svg-tZtjgkDpEmBd17UN{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;fill:#333;}@keyframes edge-animation-frame{from{stroke-dashoffset:0;}}@keyframes dash{to{stroke-dashoffset:0;}}#mermaid-svg-tZtjgkDpEmBd17UN .edge-animation-slow{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 50s linear infinite;stroke-linecap:round;}#mermaid-svg-tZtjgkDpEmBd17UN .edge-animation-fast{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 20s linear infinite;stroke-linecap:round;}#mermaid-svg-tZtjgkDpEmBd17UN .error-icon{fill:#552222;}#mermaid-svg-tZtjgkDpEmBd17UN .error-text{fill:#552222;stroke:#552222;}#mermaid-svg-tZtjgkDpEmBd17UN .edge-thickness-normal{stroke-width:1px;}#mermaid-svg-tZtjgkDpEmBd17UN .edge-thickness-thick{stroke-width:3.5px;}#mermaid-svg-tZtjgkDpEmBd17UN .edge-pattern-solid{stroke-dasharray:0;}#mermaid-svg-tZtjgkDpEmBd17UN .edge-thickness-invisible{stroke-width:0;fill:none;}#mermaid-svg-tZtjgkDpEmBd17UN .edge-pattern-dashed{stroke-dasharray:3;}#mermaid-svg-tZtjgkDpEmBd17UN .edge-pattern-dotted{stroke-dasharray:2;}#mermaid-svg-tZtjgkDpEmBd17UN .marker{fill:#333333;stroke:#333333;}#mermaid-svg-tZtjgkDpEmBd17UN .marker.cross{stroke:#333333;}#mermaid-svg-tZtjgkDpEmBd17UN svg{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;}#mermaid-svg-tZtjgkDpEmBd17UN p{margin:0;}#mermaid-svg-tZtjgkDpEmBd17UN .label{font-family:"trebuchet ms",verdana,arial,sans-serif;color:#333;}#mermaid-svg-tZtjgkDpEmBd17UN .cluster-label text{fill:#333;}#mermaid-svg-tZtjgkDpEmBd17UN .cluster-label span{color:#333;}#mermaid-svg-tZtjgkDpEmBd17UN .cluster-label span p{background-color:transparent;}#mermaid-svg-tZtjgkDpEmBd17UN .label text,#mermaid-svg-tZtjgkDpEmBd17UN span{fill:#333;color:#333;}#mermaid-svg-tZtjgkDpEmBd17UN .node rect,#mermaid-svg-tZtjgkDpEmBd17UN .node circle,#mermaid-svg-tZtjgkDpEmBd17UN .node ellipse,#mermaid-svg-tZtjgkDpEmBd17UN .node polygon,#mermaid-svg-tZtjgkDpEmBd17UN .node path{fill:#ECECFF;stroke:#9370DB;stroke-width:1px;}#mermaid-svg-tZtjgkDpEmBd17UN .rough-node .label text,#mermaid-svg-tZtjgkDpEmBd17UN .node .label text,#mermaid-svg-tZtjgkDpEmBd17UN .image-shape .label,#mermaid-svg-tZtjgkDpEmBd17UN .icon-shape .label{text-anchor:middle;}#mermaid-svg-tZtjgkDpEmBd17UN .node .katex path{fill:#000;stroke:#000;stroke-width:1px;}#mermaid-svg-tZtjgkDpEmBd17UN .rough-node .label,#mermaid-svg-tZtjgkDpEmBd17UN .node .label,#mermaid-svg-tZtjgkDpEmBd17UN .image-shape .label,#mermaid-svg-tZtjgkDpEmBd17UN .icon-shape .label{text-align:center;}#mermaid-svg-tZtjgkDpEmBd17UN .node.clickable{cursor:pointer;}#mermaid-svg-tZtjgkDpEmBd17UN .root .anchor path{fill:#333333!important;stroke-width:0;stroke:#333333;}#mermaid-svg-tZtjgkDpEmBd17UN .arrowheadPath{fill:#333333;}#mermaid-svg-tZtjgkDpEmBd17UN .edgePath .path{stroke:#333333;stroke-width:2.0px;}#mermaid-svg-tZtjgkDpEmBd17UN .flowchart-link{stroke:#333333;fill:none;}#mermaid-svg-tZtjgkDpEmBd17UN .edgeLabel{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-tZtjgkDpEmBd17UN .edgeLabel p{background-color:rgba(232,232,232, 0.8);}#mermaid-svg-tZtjgkDpEmBd17UN .edgeLabel rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-tZtjgkDpEmBd17UN .labelBkg{background-color:rgba(232, 232, 232, 0.5);}#mermaid-svg-tZtjgkDpEmBd17UN .cluster rect{fill:#ffffde;stroke:#aaaa33;stroke-width:1px;}#mermaid-svg-tZtjgkDpEmBd17UN .cluster text{fill:#333;}#mermaid-svg-tZtjgkDpEmBd17UN .cluster span{color:#333;}#mermaid-svg-tZtjgkDpEmBd17UN div.mermaidTooltip{position:absolute;text-align:center;max-width:200px;padding:2px;font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:12px;background:hsl(80, 100%, 96.2745098039%);border:1px solid #aaaa33;border-radius:2px;pointer-events:none;z-index:100;}#mermaid-svg-tZtjgkDpEmBd17UN .flowchartTitleText{text-anchor:middle;font-size:18px;fill:#333;}#mermaid-svg-tZtjgkDpEmBd17UN rect.text{fill:none;stroke-width:0;}#mermaid-svg-tZtjgkDpEmBd17UN .icon-shape,#mermaid-svg-tZtjgkDpEmBd17UN .image-shape{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-tZtjgkDpEmBd17UN .icon-shape p,#mermaid-svg-tZtjgkDpEmBd17UN .image-shape p{background-color:rgba(232,232,232, 0.8);padding:2px;}#mermaid-svg-tZtjgkDpEmBd17UN .icon-shape .label rect,#mermaid-svg-tZtjgkDpEmBd17UN .image-shape .label rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-tZtjgkDpEmBd17UN .label-icon{display:inline-block;height:1em;overflow:visible;vertical-align:-0.125em;}#mermaid-svg-tZtjgkDpEmBd17UN .node .label-icon path{fill:currentColor;stroke:revert;stroke-width:revert;}#mermaid-svg-tZtjgkDpEmBd17UN :root{--mermaid-font-family:"trebuchet ms",verdana,arial,sans-serif;} 明文存储
单向哈希
加盐哈希
自适应哈希
未来趋势: 多因子/无密码

Spring Security 中的密码哈希支持

Spring Security 通过 PasswordEncoder 接口抽象了密码编码与验证逻辑，提供多种现代自适应算法实现。

public interface PasswordEncoder {
    String encode(CharSequence rawPassword);
    boolean matches(CharSequence rawPassword, String encodedPassword);
    default boolean upgradeEncoding(String encodedPassword) {
        return false;
    }
}

核心方法：

• encode()：对原始密码进行编码，通常生成包含盐值和迭代次数的最终字符串。
• matches()：校验原始密码与已编码密码是否匹配。
• upgradeEncoding()：判断已编码的密码是否需要升级编码（例如迭代次数不足时）。

Spring Security 提供了多个内置实现：

实现类	算法	特性
BCryptPasswordEncoder	BCrypt	自适应哈希，内置盐，推荐使用
SCryptPasswordEncoder	SCrypt	内存消耗型，抗 GPU/ASIC 攻击
Argon2PasswordEncoder	Argon2	2015 年密码哈希竞赛冠军，抗并行与内存硬计算
Pbkdf2PasswordEncoder	PBKDF2	基于 HMAC 的迭代哈希，可配置伪随机函数
DelegatingPasswordEncoder	委托编码	支持多种编码格式并存，方便历史系统平滑迁移
NoOpPasswordEncoder	无操作	明文存储，仅用于测试，生产禁止使用
LdapShaPasswordEncoder	LDAP SHA	兼容 LDAP 环境的 SHA 格式

其中，BCryptPasswordEncoder 是 Spring Security 的默认推荐编码器，其构造函数可传入 strength（对数工作因子，默认 10），值越大计算越慢。生成的哈希字符串格式为 $2a$10$...，包含算法标识、迭代次数和盐值。

对于需要兼容旧系统的项目，DelegatingPasswordEncoder 极其实用：它允许数据库中存储多种格式的密码，例如旧系统使用 MD5，新用户使用 BCrypt，并在验证时自动识别前缀选择对应编码器进行匹配，同时可配置密码升级策略。

实战：配置 BCryptPasswordEncoder

以下示例基于 Spring Boot 3.x + Spring Security 6，展示如何使用 BCryptPasswordEncoder 保护用户密码，并在内存中创建测试用户。

项目依赖

在 pom.xml 中添加 spring-boot-starter-security 即可，无需额外编码器依赖，因为 spring-security-core 已包含所有实现。

安全配置类

package com.example.security;

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.security.config.annotation.web.builders.HttpSecurity;
import org.springframework.security.config.annotation.web.configuration.EnableWebSecurity;
import org.springframework.security.core.userdetails.User;
import org.springframework.security.core.userdetails.UserDetails;
import org.springframework.security.core.userdetails.UserDetailsService;
import org.springframework.security.crypto.bcrypt.BCryptPasswordEncoder;
import org.springframework.security.crypto.password.PasswordEncoder;
import org.springframework.security.provisioning.InMemoryUserDetailsManager;
import org.springframework.security.web.SecurityFilterChain;

@Configuration
@EnableWebSecurity
public class SecurityConfig {

    @Bean
    public PasswordEncoder passwordEncoder() {
        // 强度 12，适合生产环境；开发测试可使用 4~6 加速启动
        return new BCryptPasswordEncoder(12);
    }

    @Bean
    public UserDetailsService userDetailsService(PasswordEncoder encoder) {
        UserDetails user = User.builder()
                .username("user")
                .password(encoder.encode("password123"))
                .roles("USER")
                .build();

        UserDetails admin = User.builder()
                .username("admin")
                .password(encoder.encode("adminPass"))
                .roles("ADMIN")
                .build();

        return new InMemoryUserDetailsManager(user, admin);
    }

    @Bean
    public SecurityFilterChain filterChain(HttpSecurity http) throws Exception {
        http
            .authorizeHttpRequests(auth -> auth
                .requestMatchers("/public/**").permitAll()
                .anyRequest().authenticated()
            )
            .formLogin(form -> form
                .defaultSuccessUrl("/home", true)
            )
            .httpBasic(); // 同时支持 Basic Auth，方便测试

        return http.build();
    }
}

主应用类与测试接口

package com.example;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

import java.security.Principal;

@SpringBootApplication
public class SecurityPasswordApplication {
    public static void main(String[] args) {
        SpringApplication.run(SecurityPasswordApplication.class, args);
    }
}

@RestController
class HomeController {

    @GetMapping("/home")
    public String home(Principal principal) {
        return "Welcome, " + principal.getName() + "! Your password is securely stored.";
    }

    @GetMapping("/public/info")
    public String publicInfo() {
        return "This is a public endpoint.";
    }
}

运行项目后，访问 /login 使用表单登录，用户密码均经过 BCrypt 编码。PasswordEncoder 在用户认证时自动调用 matches() 进行校验，全程明码密码不出现在持久化存储中。

若需要在注册时编码密码，只需注入 PasswordEncoder 并调用 encode(rawPassword) 存入数据库，登录时由 DaoAuthenticationProvider 自动完成匹配。

密码编码器选择与迁移建议

• 新项目 ：优先使用 BCryptPasswordEncoder，它是经过广泛检验的工业标准。若系统对 GPU 攻击有较高防护需求，可考虑 Argon2PasswordEncoder。
• 旧系统迁移 ：使用 DelegatingPasswordEncoder，设置默认编码器为 BCrypt，并配置多个编码器映射。当用户登录时，系统可识别旧密码格式并自动升级为新的编码格式。

示例配置：

@Bean
public PasswordEncoder delegatingPasswordEncoder() {
    String idForEncode = "bcrypt";
    Map<String, PasswordEncoder> encoders = new HashMap<>();
    encoders.put(idForEncode, new BCryptPasswordEncoder());
    encoders.put("pbkdf2", Pbkdf2PasswordEncoder.defaultsForSpringSecurity_v5_8());
    encoders.put("scrypt", SCryptPasswordEncoder.defaultsForSpringSecurity_v5_8());
    encoders.put("sha256", new StandardPasswordEncoder()); // 已废弃，仅作迁移示例

    return new DelegatingPasswordEncoder(idForEncode, encoders);
}

存储的密码格式为 {bcrypt}$2a$10$...，迁移后登录成功的用户密码会自动更新为新的 bcrypt 格式，平滑过渡。

总结

密码存储安全是 Web 安全体系中最基础也最容易被低估的一环。从明文到自适应哈希，每一次进化都直接回应了攻击手段的升级。Spring Security 提供了完善且易用的 PasswordEncoder 体系，使得开发者仅需简单配置即可使用业界最佳实践，而不必重复造轮子。

在实际项目中，结合 BCrypt 或 Argon2 自适应哈希，配合委托编码器实现灵活迁移，能显著增强用户凭证的安全性。