更新用户资料与授权关系#

验证状态：已源码核验、未联调；适用基线：源码归纳 @ 2026-09-14

用途与场景#

更新用户。

使用位置#

页面/功能	角色或空间分支
更新用户资料与授权关系	当前 $spaceId；按钮可见性与后端授权分别校验

端点#

PUT /main-service/system-api/user-center/user/updateById — 更新用户。

端点全量事实（参数、请求/响应字段、错误码、权限点）见清单层 user-center · user 用户；业务语义（wire 惯例、限频、租户声明等）见用户中心业务 · user 用户。

动线与完成判据#

更新范围是混合操作：用户主表按全局 userId 更新，角色、用户组和用户-租户关系只在当前租户内同步（见用户中心业务 · user 用户）。status=200 && data=true 才表示目标更新/删除 SQL 报告成功；data=false 可表示目标不存在或没有受影响行。当前 Web 的成功 toast 不检查 data，App 不应复制这一判定。

错误与边界#

错误出口与四类映射见错误响应差异。用户名重复返回 User exists/User repeat；关联同步或存储失败会回滚事务。本组写操作无幂等键；超时后须先核对资源状态再决定重试。

调用关系与资源清理#

事务内同步授权关系与资料；提交后 best-effort 刷新 MQTT 用户账号。portraitUrl 只作为字符串写入，本操作不上传或验证文件。

已知缺口#

字符串仅在非空时更新，不能用空字符串清除；对非当前用户 roleIds=[] 不会清空角色，当前登录用户自身的角色/用户组变更被跳过。portraitUrl 的最终 /files 服务责任与鉴权/缓存不由本操作闭合。无已知关键缺口；未执行真实联调。