Android（Java）多角色用户登录：同一账号多角色场景实现咨询

1. 后端接口适配（前置要求） #

• 原有登录接口返回体新增bindRoleList字段，类型为List<Role>，单角色账号该字段仅返回1条数据
• 可选新增角色切换接口：入参为账号有效token + 目标roleId，出参返回对应角色的专属权限配置、角色维度的用户信息（如商家角色返回店铺ID、学生角色返回班级信息）

轻量场景替代方案：如果角色权限配置数据量小，可在登录接口全量返回所有绑定角色的权限信息，前端切换角色时无需额外调用接口，降低交互成本。

2. 本地数据结构改造 #

首先定义角色实体类Role.java：

public class Role {
    // 核心必填字段
    private int roleId;
    private String roleName;
    private int permissionLevel;
    // 扩展字段，存储对应角色的专属业务数据
    private String extJson;

    // 省略Getter、Setter方法
}

改造原有用户信息实体类UserInfo.java，新增多角色相关字段：

public class UserInfo {
    // 原有单角色逻辑字段保留，如userId、account、通用token等
    private String userId;
    private String commonToken;
    // 多角色新增字段
    private Role currentSelectedRole;
    private List<Role> bindRoleList;

    // 省略Getter、Setter方法
}

• 本地持久化层（SharedPreferences/Room）同步新增对应字段的存储逻辑，登录成功后全量存储账号绑定的所有角色信息，APP重启后无需重复拉取。

3. 登录流程改造 #

原有账号校验（密码/验证码/第三方登录）逻辑保持不变，校验通过后按以下逻辑处理：

• 若返回的bindRoleList长度为1：自动选中该角色，直接进入对应角色的首页，完全兼容原有单角色业务逻辑
• 若返回的bindRoleList长度≥2：跳转角色选择页，展示所有绑定角色的卡片/列表供用户选择，用户确认后再进入对应角色的首页

可选优化：可记录用户上一次登录选中的角色，下次登录时默认选中，减少用户操作步骤。

4. 全局角色切换功能实现 #

在「我的」页面、首页侧边栏等高频入口增加角色切换按钮，点击后弹出绑定角色选择弹窗，切换逻辑如下：

• 若采用后端切换接口方案：选中目标角色后调用切换接口，获取对应角色的权限数据后更新本地currentSelectedRole字段
• 若采用本地缓存方案：直接读取本地存储的目标角色信息更新currentSelectedRole
• 切换完成后清空原有页面栈，重建对应角色的首页导航结构，避免旧角色页面残留
• 同步更新全局权限拦截器的判断依据为当前选中角色的permissionLevel

5. 权限校验逻辑适配 #

原有全局路由拦截、操作权限校验逻辑全部改为从当前登录用户的currentSelectedRole字段取权限值判断，示例代码如下：

// 全局权限校验工具类示例
public class PermissionChecker {
    public static boolean hasPermission(int requiredPermissionLevel) {
        UserInfo currentUser = UserManager.getInstance().getCurrentUser();
        if (currentUser == null || currentUser.getCurrentSelectedRole() == null) {
            return false;
        }
        return currentUser.getCurrentSelectedRole().getPermissionLevel() >= requiredPermissionLevel;
    }
}

踩坑提醒：不要将角色信息和账号信息拆分存储，统一放到UserInfo实体下管理，避免出现本地缓存的账号和角色信息不匹配的问题。

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