Spring Boot 2应用添加持久化Remember Me功能失败求助

我明白你在配置Spring Boot 2的Remember Me功能时遇到了头疼的问题——勾选了复选框却没生成Cookie，还没任何异常提示，这种“静默失败”确实很让人困惑。结合Spring Security的常见配置坑，我给你梳理几个排查方向和正确的配置示例：

一、先检查核心配置是否缺失 #

Spring Security的Remember Me功能依赖几个关键组件，先对比你的代码看看有没有遗漏：

import javax.sql.DataSource;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.security.config.annotation.authentication.builders.AuthenticationManagerBuilder;
import org.springframework.security.config.annotation.web.builders.HttpSecurity;
import org.springframework.security.config.annotation.web.configuration.EnableWebSecurity;
import org.springframework.security.config.annotation.web.configuration.WebSecurityConfigurerAdapter;
import org.springframework.security.core.userdetails.UserDetailsService;
import org.springframework.security.crypto.password.PasswordEncoder;
import org.springframework.security.web.authentication.rememberme.JdbcTokenRepositoryImpl;
import org.springframework.security.web.authentication.rememberme.PersistentTokenRepository;

@Configuration
@EnableWebSecurity
public class SecurityConfiguration extends WebSecurityConfigurerAdapter {

    @Autowired
    private DataSource dataSource;

    @Autowired
    private UserDetailsService userDetailsService;

    @Autowired
    private PasswordEncoder passwordEncoder;

    @Override
    protected void configure(HttpSecurity http) throws Exception {
        http
            .authorizeRequests()
                .antMatchers("/login", "/css/**").permitAll()
                .anyRequest().authenticated()
                .and()
            .formLogin()
                .loginPage("/login")
                .permitAll()
                .and()
            // 重点：开启并配置Remember Me
            .rememberMe()
                .key("your-unique-secret-key-123") // 必须配置，用于签名令牌，自定义唯一值
                .userDetailsService(userDetailsService) // 必须指定，用于加载用户信息
                .tokenRepository(persistentTokenRepository()) // 可选但推荐：持久化令牌到数据库
                .tokenValiditySeconds(86400); // 令牌有效期，这里设为1天
    }

    // 配置持久化令牌的数据库仓库
    @Bean
    public PersistentTokenRepository persistentTokenRepository() {
        JdbcTokenRepositoryImpl tokenRepository = new JdbcTokenRepositoryImpl();
        tokenRepository.setDataSource(dataSource);
        // 第一次启动时可自动建表，生产环境建议手动执行SQL创建
        // tokenRepository.setCreateTableOnStartup(true);
        return tokenRepository;
    }

    @Override
    protected void configure(AuthenticationManagerBuilder auth) throws Exception {
        auth.userDetailsService(userDetailsService).passwordEncoder(passwordEncoder);
    }
}

二、前端表单的关键细节 #

务必确保登录表单的复选框name属性严格为remember-me，Spring Security默认监听这个参数名：

<form action="/login" method="post">
    <input type="text" name="username" placeholder="用户名"/>
    <input type="password" name="password" placeholder="密码"/>
    <input type="checkbox" name="remember-me" id="rememberMe"/>
    <label for="rememberMe">记住我</label>
    <button type="submit">登录</button>
    <!-- 必须包含CSRF令牌，Spring Boot默认开启CSRF防护 -->
    <input type="hidden" name="${_csrf.parameterName}" value="${_csrf.token}"/>
</form>

三、常见配置坑点排查 #

• 遗漏rememberMe().key(...)：这个密钥是令牌签名的核心，必须配置，缺失的话Spring Security会静默跳过Remember Me功能，不会抛出异常。
• 未指定UserDetailsService：如果用了自定义用户认证逻辑，必须在Remember Me配置中指定该服务，否则Spring无法加载用户信息验证令牌。
• 数据库表未创建：如果用持久化令牌，需要手动创建表（生产环境不建议自动建表），MySQL的建表SQL如下：

CREATE TABLE persistent_logins (
    username VARCHAR(64) NOT NULL,
    series VARCHAR(64) PRIMARY KEY,
    token VARCHAR(64) NOT NULL,
    last_used TIMESTAMP NOT NULL
);

• CSRF拦截：登录表单必须包含CSRF令牌，否则请求会被拦截，Remember Me自然无法生效。
• 浏览器Cookie设置：检查浏览器是否禁用了Cookie，或者设置了“关闭浏览器清除Cookie”，这会导致Remember Me Cookie无法持久化。

四、调试技巧 #

如果还是没生效，开启Spring Security的DEBUG日志，能帮你定位问题：
在application.properties中添加：

logging.level.org.springframework.security=DEBUG

登录时观察日志，会输出Remember Me的处理流程，比如是否检测到remember-me参数、是否生成令牌等。

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