在若依（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);

通過上述代碼，新注冊用戶將自動關聯指定角色，獲得對應權限。

?