解决XXL-JOB账号被挤下线的烦恼：支持多地点同时登录的秘籍

原创已于 2025-10-15 23:31:17 修改 · 546 阅读 ·

本内容遵循CC 4.0 BY-SA版权协议

GEO检测

摩羯座程序员

关注

标签

#java #开发语言

分类后端开发

于 2025-10-15 13:04:35 首次发布

背景：

在日常运维中，你有没有遇到过这样的困扰：当你正小心翼翼地修改定时任务配置，准备点击保存时，页面突然跳转到了登录界面，所有未保存的操作都丢失了——这就是我们团队在将 XXL-JOB 升级到新版本后遇到的协作痛点。这个问题严重影响了团队之间的协作效率。今天，我们就来分享一种直截了当的解决方式。

问题根源：

最新版本xxl-job由三个部分组成：

（1）xxl-job-core是核心，负责任务调度逻辑；

（2）xxl-job-admin负责管理和触发任务；

（3）xxl-sso负责检查身份，确保只有授权的用户才能进入。

问题出在登录机制上。在xxl-job-admin的登录中会调用到 com.xxl.job.admin.controller.login.doLogin方法

@RequestMapping(value="/doLogin", method=RequestMethod.POST)
@ResponseBody
@XxlSso(login = false)
public ReturnT<String> doLogin(HttpServletRequest request,
                         HttpServletResponse response,
                         @RequestParam("userName") String userName,
                         @RequestParam("password") String password,
                         @RequestParam(value = "ifRemember", required = false) String ifRemember){

    // param
    boolean ifRem = StringTool.isNotBlank(ifRemember) && "on".equals(ifRemember);
    if (StringTool.isBlank(userName) || StringTool.isBlank(password)){
       return ReturnT.ofFail( I18nUtil.getString("login_param_empty") );
    }

    // valid user、status
    XxlJobUser xxlJobUser = xxlJobUserMapper.loadByUserName(userName);
    if (xxlJobUser == null) {
       return ReturnT.ofFail( I18nUtil.getString("login_param_unvalid") );
    }

    // valid passowrd
    String passwordHash = SHA256Tool.sha256(password);
    if (!passwordHash.equals(xxlJobUser.getPassword())) {
       return ReturnT.ofFail( I18nUtil.getString("login_param_unvalid") );
    }

    // xxl-sso, do login
    LoginInfo loginInfo = new LoginInfo(String.valueOf(xxlJobUser.getId()), UUIDTool.getSimpleUUID());
    Response<String> result= XxlSsoHelper.loginWithCookie(loginInfo, response, ifRem);

    return ReturnT.of(result.getCode(), result.getMsg());
}

在Response result = XxlSsoHelper.loginWithCookie(loginInfo, response, ifRem) 方法中，会生成保存token、并返回请求响应。具体来看生成token和保存的过程：通过调用loginWithCookie--->login--->TokenHelper.generateToken()；最后保存到user表中。

public static Response<String> loginWithCookie(LoginInfo loginInfo, HttpServletResponse response, boolean ifRemember) {
    Response<String> loginResult = login(loginInfo);
    if (loginResult.isSuccess()) {
        String token = (String)loginResult.getData();
        CookieTool.set(response, getInstance().getTokenKey(), token, ifRemember);
    }

    return loginResult;
}

public static Response<String> login(LoginInfo loginInfo) {
    Response<String> tokenResponse = TokenHelper.generateToken(loginInfo);
    if (!tokenResponse.isSuccess()) {
        return tokenResponse;
    } else {
        loginInfo.setExpireTime(System.currentTimeMillis() + getInstance().getTokenTimeout());
        Response<String> setResponse = getInstance().getLoginStore().set(loginInfo);
        return !setResponse.isSuccess() ? setResponse : Response.ofSuccess((String)tokenResponse.getData());
    }
}

@Override
public Response<String> set(LoginInfo loginInfo) {

    // parse token-signature
    String token_sign = loginInfo.getSignature();

    // write token by UserId
    int ret = xxlJobUserMapper.updateToken(Integer.parseInt(loginInfo.getUserId()), token_sign);
    return ret > 0 ? Response.ofSuccess() : Response.ofFail("token set fail");
}

问题本质

当同一个账号在另一个客户端登录时，当前已登录的客户端会被强制退出，这就导致了文章开头描述的场景——操作过程中的意外跳转。

解决方案

我们可以通过修改 LoginInfo 的生成信息来简单直接地解决这个问题。修改后的代码如下：

// 修改前：每次生成随机 UUID
LoginInfo loginInfo = new LoginInfo(String.valueOf(xxlJobUser.getId()), UUIDTool.getSimpleUUID());

// 修改后：使用固定签名值
LoginInfo loginInfo = new LoginInfo(String.valueOf(xxlJobUser.getId()), "fixed_signature_value");