若依框架开启注册功能全流程指南

在若依（RuoYi）框架中，用户注册功能并非默认开启，需要通过后端配置、前端调整以及必要的角色分配设置来实现。本文将详细介绍开启注册功能的完整步骤，帮助开发者快速完成配置。

一、后端配置：开启注册功能开关

若依框架通过系统配置表（sys_config）控制注册功能的启用状态，需通过以下步骤修改配置：

1. 理解注册功能的后端控制逻辑

后端注册接口的核心逻辑位于 SysRegisterController 中，关键代码如下：

@PostMapping("/register")
public AjaxResult register(@RequestBody RegisterBody user) {
    // 检查系统是否开启注册功能
    if (!("true".equals(configService.selectConfigByKey("sys.account.registerUser")))) {
        return error("当前系统没有开启注册功能!");
    }
    String msg = registerService.register(user);
    return StringUtils.isEmpty(msg) ? success() : error(msg);
}

代码中通过 configService.selectConfigByKey("sys.account.registerUser") 读取配置，若值为 true 则允许注册，否则返回错误提示。

2. 修改系统配置表（sys_config）

配置项存储在数据库的 sys_config 表中，需将 “账号自助 - 是否开启用户注册功能” 对应的配置值改为 true：

• 找到 sys_config 表中 config_key 为 sys.account.registerUser 的记录（通常为表中第 5 条记录）；
• 将该记录的 config_value 字段修改为 true（表示开启注册功能）；
• 若该配置项不存在，可手动插入一条：config_name 为 “账号自助 - 是否开启用户注册功能”，config_key 为 sys.account.registerUser，config_value 为 true，config_type 为 Y。

3. 验证后端配置

修改后，后端会通过 sysConfigMapper.xml 映射文件读取配置，确保 sysConfigMapper.xml 中包含正确的配置表映射：

<!-- sysConfigMapper.xml 中关键配置 -->
<resultMap type="SysConfig" id="SysConfigResult">
    <id property="configId" column="config_id"/>
    <result property="configKey" column="config_key"/>
    <result property="configValue" column="config_value"/>
    <!-- 其他字段映射 -->
</resultMap>

<sql id="selectConfigVo">
    select config_id, config_key, config_value from sys_config
</sql>

确保映射文件能正确读取 config_key 和 config_value 字段，避免配置读取失败。

二、前端调整：显示注册入口

前端需修改登录页面配置，使注册入口可见：

1. 找到前端配置文件

前端登录页面的配置位于 src/views/login.vue 中，该文件控制登录页的显示逻辑，包括注册开关。

2. 开启注册开关

在 login.vue 的 data() 方法中，将 register 属性设置为 true：

data() {
    return {
        // 其他配置...
        captchaOnOff: true, // 验证码开关
        register: true, // 注册开关：设为true显示注册入口
        redirect: undefined
    };
}

修改后，登录页面将显示 “注册” 按钮，用户可点击进入注册流程。

三、注册时自动分配角色（可选）

默认情况下，新注册用户可能没有任何角色权限，需手动或自动分配角色。若需注册时自动赋予角色，需通过以下步骤实现：

1. 理解用户与角色的关联关系

若依框架基于 RBAC（Role-Based Access Control）权限模型设计，用户与角色的关联通过 sys_user_role 表维护（多对多关系）。因此，为新用户分配角色需向该表插入关联记录。

2. 调用批量新增角色关联的方法

若依框架已封装好批量新增用户角色的方法，位于 SysUserRoleMapper 中：

/**
 * 批量新增用户角色信息
 * @param userRoleList 用户角色列表
 * @return 结果
 */
public int batchUserRole(List<SysUserRole> userRoleList);

对应的 XML 实现（SysUserRoleMapper.xml）：

<insert id="batchUserRole">
    insert into sys_user_role(user_id, role_id) 
    values 
    <foreach item="item" index="index" collection="list" separator=",">
        (#{item.userId}, #{item.roleId})
    </foreach>
</insert>

3. 在注册流程中调用角色分配方法

在用户注册成功后（即 registerService.register(user) 方法内部），可添加角色分配逻辑：

// 注册用户成功后，获取新用户ID
Long userId = ...; 
// 准备角色关联列表（例如默认赋予“普通用户”角色，roleId=2）
List<SysUserRole> userRoles = new ArrayList<>();
userRoles.add(new SysUserRole(userId, 2L)); 
// 调用批量新增方法
sysUserRoleMapper.batchUserRole(userRoles);

通过上述代码，新注册用户将自动关联指定角色，获得对应权限。