如何在后端用SaToken凭账号密码直通首页？

Question

如何在后端使用SaToken通过账号密码认证后直接跳转至首页？常见问题在于：调用`StpUtil.login()`完成登录后，未正确返回前端所需的Token信息或会话凭证，导致前端无法携带有效token请求首页资源。此外，部分开发者忽略配置`sa-token.token-name`或未设置`StpUtil.setLoginId()`后的响应头，致使浏览器无法识别认证状态，造成“已登录却无法直通首页”的假象。如何确保登录成功后返回Token并维持会话？

Answer 1

让【宝码香车】来帮您解答，本回答参考DeepSeek编写，并整理提供。

如果答案能帮助您，请采纳，非常感谢！
.
每日一句正能量，让它带给您好心情：别让过去的阴影，遮挡你未来的阳光。
.

后端使用SaToken实现账号密码登录并直通首页

核心解决方案

1. 基础登录认证流程

@RestController
@RequestMapping("/auth")
public class LoginController {
    
    @PostMapping("/login")
    public AjaxResult login(@RequestBody LoginDto loginDto) {
        // 1. 验证账号密码
        User user = userService.findByUsername(loginDto.getUsername());
        if (user == null || !passwordEncoder.matches(loginDto.getPassword(), user.getPassword())) {
            return AjaxResult.error("账号或密码错误");
        }
        
        // 2. 执行登录操作
        StpUtil.login(user.getId());
        
        // 3. 获取Token信息
        String tokenValue = StpUtil.getTokenValue();
        String tokenName = StpUtil.getTokenName();
        
        // 4. 返回Token给前端
        Map<String, Object> result = new HashMap<>();
        result.put("tokenName", tokenName);
        result.put("tokenValue", tokenValue);
        result.put("loginId", user.getId());
        result.put("redirectUrl", "/home");
        
        return AjaxResult.success("登录成功", result);
    }
}

2. 配置SaToken确保Token正确返回

@Configuration
public class SaTokenConfigure implements WebMvcConfigurer {
    
    @Override
    public void addInterceptors(InterceptorRegistry registry) {
        // 注册Sa-Token的拦截器
        registry.addInterceptor(new SaInterceptor())
                .addPathPatterns("/**")
                .excludePathPatterns("/auth/login", "/auth/logout");
    }
}

# application.yml 配置
sa-token:
  # Token名称 (也是cookie名称)
  token-name: satoken
  # Token有效期，单位秒，默认30天
  timeout: 2592000
  # Token临时有效期 (指定时间内无操作就视为token过期) 单位: 秒
  activity-timeout: -1
  # 是否允许同一账号并发登录 (为true时允许一起登录, 为false时新登录挤掉旧登录)
  is-concurrent: true
  # 在多人登录同一账号时，是否共用一个token (为true时所有登录共用一个token, 为false时每次登录新建一个token)
  is-share: true
  # Token风格
  token-style: uuid
  # 是否输出操作日志
  is-log: true

3. 前端处理Token并跳转首页

// 前端登录请求处理
async function handleLogin(loginData) {
    try {
        const response = await axios.post('/auth/login', loginData);
        if (response.data.code === 200) {
            const { tokenName, tokenValue, redirectUrl } = response.data.data;
            
            // 存储Token到本地
            localStorage.setItem(tokenName, tokenValue);
            
            // 设置axios默认请求头
            axios.defaults.headers.common[tokenName] = tokenValue;
            
            // 跳转到首页
            window.location.href = redirectUrl;
        } else {
            alert(response.data.msg);
        }
    } catch (error) {
        console.error('登录失败:', error);
    }
}

常见问题解决方案

1. Token未正确返回问题

@PostMapping("/login")
public AjaxResult login(@RequestBody LoginDto loginDto, HttpServletResponse response) {
    // ... 验证逻辑
    
    // 执行登录并手动设置响应头
    StpUtil.login(user.getId());
    
    // 确保Token写入响应头
    response.setHeader(StpUtil.getTokenName(), StpUtil.getTokenValue());
    
    // 返回完整的认证信息
    LoginResult result = new LoginResult();
    result.setTokenName(StpUtil.getTokenName());
    result.setTokenValue(StpUtil.getTokenValue());
    result.setLoginId(StpUtil.getLoginIdAsLong());
    result.setSessionTimeout(StpUtil.getTokenTimeout());
    
    return AjaxResult.success("登录成功", result);
}

2. 会话维持配置

@Component
public class StpInterfaceImpl implements StpInterface {
    
    @Override
    public List<String> getPermissionList(Object loginId, String loginType) {
        // 返回用户权限列表
        return userService.getPermissions(loginId);
    }
    
    @Override
    public List<String> getRoleList(Object loginId, String loginType) {
        // 返回用户角色列表
        return userService.getRoles(loginId);
    }
}

3. 首页接口保护

@RestController
@RequestMapping("/home")
public class HomeController {
    
    @SaCheckLogin
    @GetMapping("/index")
    public AjaxResult homePage() {
        // 只有登录用户才能访问
        Long loginId = StpUtil.getLoginIdAsLong();
        User user = userService.findById(loginId);
        
        Map<String, Object> data = new HashMap<>();
        data.put("userInfo", user);
        data.put("menus", userService.getUserMenus(loginId));
        
        return AjaxResult.success("获取首页数据成功", data);
    }
}

完整的数据模型

// 登录DTO
@Data
public class LoginDto {
    private String username;
    private String password;
}


// 登录结果
@Data
public class LoginResult {
    private String tokenName;
    private String tokenValue;
    private Long loginId;
    private long sessionTimeout;
    private String redirectUrl;
}


// 统一返回结果
@Data
public class AjaxResult {
    private Integer code;
    private String msg;
    private Object data;
    
    public static AjaxResult success(String msg, Object data) {
        AjaxResult result = new AjaxResult();
        result.setCode(200);
        result.setMsg(msg);
        result.setData(data);
        return result;
    }
    
    public static AjaxResult error(String msg) {
        AjaxResult result = new AjaxResult();
        result.setCode(500);
        result.setMsg(msg);
        return result;
    }
}

关键注意事项

1. 确保Token名称一致性：前后端使用的Token名称必须一致
2. 配置跨域支持：如果前后端分离，需要配置CORS
3. Token存储安全：避免将Token存储在容易被攻击的位置
4. 会话超时处理：前端需要处理Token过期的情况
5. 登录状态验证：重要操作前验证登录状态

按照以上方案实现，可以确保用户通过账号密码登录后，能够正确获取Token并直接跳转到首页，同时维持有效的会话状态。