修改密码

docs/CurrentUserPasswordApi.md

@@ -0,0 +1,127 @@
+# 当前登录账号修改密码接口说明
+
+## 功能说明
+
+- 适用范围：任意端口账号登录后修改当前登录账号自己的密码
+- 安全限制：只能修改当前登录态对应账号的密码，不能修改其他账号或其他端口账号的密码
+- 推荐接口：`PUT /system/user/profile/updatePwd`
+- 兼容接口：`PUT /system/user/profile/updateSubPwd`
+
+## 规则说明
+
+- 超级管理员修改的是 `sys_user.password`
+- 普通端口账号修改的是当前登录端口记录 `sys_user_login_port.sub_password`
+- 后端会从当前登录 token 中自动识别当前账号
+- 前端不需要传目标账号 ID
+- 如果传了 `portId`，且与当前登录端口不一致，后端会直接返回失败：`只能修改当前登录账号密码`
+
+## 1. 推荐接口
+
+- 路径：`PUT /system/user/profile/updatePwd`
+- 说明：当前登录用户修改自己的密码
+
+### 请求头
+
+| 请求头 | 是否必填 | 说明 |
+| --- | --- | --- |
+| `Authorization` | 是 | 登录 token |
+| `isEncrypt` | 是 | 传 `true`，与现有加密请求保持一致 |
+| `repeatSubmit` | 否 | 可传 `false` |
+| `Content-Type` | 是 | `application/json` |
+
+### 请求参数
+
+| 字段 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `oldPassword` | String | 是 | 旧密码 |
+| `newPassword` | String | 是 | 新密码 |
+| `portId` | Long | 否 | 非必填；建议不要传，若传入的不是当前登录端口 ID 会被拒绝 |
+
+### 请求示例
+
+```json
+{
+  "oldPassword": "123456",
+  "newPassword": "NewPwd@2026"
+}
+```
+
+### 返回成功示例
+
+```json
+{
+  "code": 200,
+  "msg": "操作成功",
+  "data": null
+}
+```
+
+### 常见失败响应
+
+| 提示 | 说明 |
+| --- | --- |
+| `修改密码失败，旧密码错误` | 旧密码校验失败 |
+| `新密码不能与旧密码相同` | 新旧密码一致 |
+| `只能修改当前登录账号密码` | 试图修改非当前登录端口账号密码 |
+| `当前登录账号未绑定端口，无法修改密码` | 当前登录态无端口信息 |
+| `当前登录账号不存在或无权修改` | 当前登录端口记录不存在或不属于当前用户 |
+| `修改密码异常，请联系管理员` | 数据更新失败 |
+
+## 2. 兼容接口
+
+- 路径：`PUT /system/user/profile/updateSubPwd`
+- 说明：为兼容历史前端保留，实际安全限制与推荐接口一致，也只能修改当前登录账号密码
+
+### 请求方式
+
+- `body` 仍传：
+
+```json
+{
+  "oldPassword": "123456",
+  "newPassword": "NewPwd@2026"
+}
+```
+
+- 历史前端若在 query 中传 `portId`，只有在它等于当前登录端口 ID 时才允许通过
+
+## 3. 前端调用示例
+
+### Web 端
+
+```ts
+request({
+  url: '/system/user/profile/updatePwd',
+  method: 'put',
+  headers: {
+    isEncrypt: true,
+    repeatSubmit: false
+  },
+  data: {
+    oldPassword,
+    newPassword
+  }
+})
+```
+
+### uni-app / 移动端
+
+```js
+request({
+  url: '/system/user/profile/updatePwd',
+  method: 'put',
+  header: {
+    isEncrypt: true
+  },
+  data: {
+    oldPassword,
+    newPassword
+  }
+})
+```
+
+## 4. 对接建议
+
+- 新接入前端统一调用 `PUT /system/user/profile/updatePwd`
+- 不要让前端选择目标账号，也不要透传其他账号或其他端口的 `portId`
+- 修改成功后，建议前端提示用户重新使用新密码登录

src/main/java/org/dromara/system/controller/system/SysProfileController.java

@@ -148,8 +148,28 @@ public class SysProfileController extends BaseController {
     @PutMapping("/updatePwd")
     public R<Void> updatePwd(@Validated @RequestBody SysUserPasswordBo bo) {
         Long userId = LoginHelper.getUserId();
-        // 如果是超级管理员，走原来的密码修改逻辑
         if (LoginHelper.isSuperAdmin(userId)) {
+            return updateAdminPwd(bo, userId);
+        }
+        return updateCurrentLoginPortPwd(bo, bo.getPortId());
+    }
+
+    /**
+     * 修改子密码
+     *
+     * @param bo     新旧密码
+     * @param portId 端口ID
+     */
+    @RepeatSubmit
+    @ApiEncrypt
+    @Log(title = "个人信息", businessType = BusinessType.UPDATE)
+    @PutMapping("/updateSubPwd")
+    public R<Void> updateSubPwd(@Validated @RequestBody SysUserPasswordBo bo, @RequestParam(required = false) Long portId) {
+        Long requestedPortId = portId != null ? portId : bo.getPortId();
+        return updateCurrentLoginPortPwd(bo, requestedPortId);
+    }
+
+    private R<Void> updateAdminPwd(SysUserPasswordBo bo, Long userId) {
         SysUserVo user = userService.selectUserById(userId);
         String password = user.getPassword();
         if (!BCrypt.checkpw(bo.getOldPassword(), password)) {
@@ -165,54 +185,23 @@ public class SysProfileController extends BaseController {
         return R.fail("修改密码异常，请联系管理员");
     }
 
-        // 普通用户，修改当前登录端口的子密码
+    private R<Void> updateCurrentLoginPortPwd(SysUserPasswordBo bo, Long requestedPortId) {
-        // 优先使用前端传来的 portId
-        Long targetPortId = bo.getPortId();
-        if (targetPortId == null) {
-            targetPortId = LoginHelper.getLoginUser().getCompanyRoleId();
-        }
-
-        if (targetPortId == null) {
-            return R.fail("无法确定修改的目标企业，请指定portId");
-        }
-
-        return updateSubPwd(bo, targetPortId);
-    }
-
-    /**
-     * 修改子密码
-     *
-     * @param bo     新旧密码
-     * @param portId 端口ID
-     */
-    @RepeatSubmit
-    @ApiEncrypt
-    @Log(title = "个人信息", businessType = BusinessType.UPDATE)
-    @PutMapping("/updateSubPwd")
-    public R<Void> updateSubPwd(@Validated @RequestBody SysUserPasswordBo bo, @RequestParam(required = false) Long portId) {
         Long userId = LoginHelper.getUserId();
-        Long targetPortId = portId;
+        if (LoginHelper.getLoginUser() == null || LoginHelper.getLoginUser().getCompanyRoleId() == null) {
-        if (targetPortId == null) {
+            return R.fail("当前登录账号未绑定端口，无法修改密码");
-            targetPortId = LoginHelper.getLoginUser().getCompanyRoleId();
         }
-        if (targetPortId == null) {
+        Long currentPortId = LoginHelper.getLoginUser().getCompanyRoleId();
-            return R.fail("无法确定修改的目标企业，请指定portId");
+        if (requestedPortId != null && !requestedPortId.equals(currentPortId)) {
+            return R.fail("只能修改当前登录账号密码");
         }
 
-        // Fetch port
+        SysUserLoginPort currentPort = sysUserLoginPortService.getById(currentPortId);
-        SysUserLoginPort port = sysUserLoginPortService.getById(targetPortId);
+        if (currentPort == null || !userId.equals(currentPort.getUserId())) {
-        if (port == null || !port.getUserId().equals(userId)) {
+            return R.fail("当前登录账号不存在或无权修改");
-            return R.fail("未找到对应企业端口或无权修改");
         }
 
-        // Check old password
+        String currentSubPwd = currentPort.getSubPassword();
-        String currentSubPwd = port.getSubPassword();
         if (StringUtils.isBlank(currentSubPwd)) {
-            // 如果没有设置子密码，视为未设置密码或无法修改（需根据业务决定，这里假设必须先有子密码）
-            // 或者，如果为空，允许直接设置？
-            // 考虑到用户迁移，如果为空，可能允许使用空密码验证？或者要求联系管理员重置。
-            // 这里遵循用户指令：完全依赖子密码。如果为空，可能无法通过旧密码验证。
-            // 但为了首次设置，如果为空，允许旧密码为空？
             if (StringUtils.isNotBlank(bo.getOldPassword())) {
                 return R.fail("修改密码失败，旧密码错误");
             }
@@ -220,18 +209,17 @@ public class SysProfileController extends BaseController {
             if (!BCrypt.checkpw(bo.getOldPassword(), currentSubPwd)) {
                 return R.fail("修改密码失败，旧密码错误");
             }
-        }
-
             if (BCrypt.checkpw(bo.getNewPassword(), currentSubPwd)) {
                 return R.fail("新密码不能与旧密码相同");
             }
+        }
 
-        // Update
+        currentPort.setSubPassword(BCrypt.hashpw(bo.getNewPassword()));
-        port.setSubPassword(BCrypt.hashpw(bo.getNewPassword()));
+        if (sysUserLoginPortService.updateById(currentPort)) {
-        sysUserLoginPortService.updateById(port);
-
             return R.ok();
         }
+        return R.fail("修改密码异常，请联系管理员");
+    }
 
     /**
      * 头像上传