『博客开发日记-后台』之修改用户个人中心信息接口的实现

修改用户个人中心信息接口的实现

---

修改用户个人中心信息接口的需求

和前台修改用户信息差不多，就算请求参数不同

检测用户是否登录

昵称不能为空

XSS防护：转义昵称

敏感词检测 - 昵称

获取更新前的用户信息，用于判断头像和昵称是否变化

处理头像：如果是临时文件，转为正式文件

根据当前用户和头像来源查找文件记录，存在则更新，不存在则新增

如果头像发生变化，删除OSS上的旧头像

如果头像或昵称发生变化，同步更新评论表中该用户的所有评论

---

代码实现

在 AdminUserController 中

 @PutMapping("/profile")
@SystemLog(businessName = "修改个人中心信息接口")
@ApiOperation(value = "修改个人中心信息接口", notes = "修改个人中心信息", response = String.class)
public ResponseResult updateUserProfile(@Valid @RequestBody UpdateUserProfileDto updateUserProfileDto)
{
    return adminUserService.updateUserProfile(updateUserProfileDto);
}

---

创建 UpdateUserProfileDto

/**
 * 修改个人中心信息请求DTO
 */
@Data
@AllArgsConstructor
@NoArgsConstructor
@ApiModel(description = "修改个人中心信息请求对象")
public class UpdateUserProfileDto
{
    @NotBlank(message = "昵称不能为空")
    @ApiModelProperty(value = "昵称", required = true, example = "云梦泽")
    private String nickname;

    @ApiModelProperty(value = "用户头像url", example = "https://avatars.githubusercontent.com/u/155459505?v=4")
    private String avatar;

    @ApiModelProperty(value = "用户性别，（0 男，1 女，2 隐藏）", example = "0")
    private String sex;
}

---

在 AdminUserServiceImpl 中

//修改用户个人中心信息
@Override
@Transactional
public ResponseResult updateUserProfile(UpdateUserProfileDto updateUserProfileDto)
{
    //检测用户是否登录
    Long currentUserId = SecurityUtils.getUserId();
    if (currentUserId == null) {
        return ResponseResult.errorResult(AppHttpCodeEnum.NEED_LOGIN);
    }

    //昵称不能为空
    if (!StringUtils.hasText(updateUserProfileDto.getNickname())) {
        return ResponseResult.errorResult(AppHttpCodeEnum.NICKNAME_NOT_NULL, "昵称不能为空");
    }

    //XSS防护：转义昵称
    String safeNickname = XssUtils.escapeHtml(updateUserProfileDto.getNickname());
    updateUserProfileDto.setNickname(safeNickname);

    //敏感词检测 - 昵称
    if (sensitiveUtilService.checkSensitiveWordsSimple(updateUserProfileDto.getNickname())) {
        return ResponseResult.errorResult(AppHttpCodeEnum.SYSTEM_ERROR, "昵称包含敏感词，请修改后重试");
    }

    //获取更新前的用户信息，用于判断头像和昵称是否变化
    SysUser oldSysUser = getById(currentUserId);

    //处理头像：如果是临时文件，转为正式文件
    String avatar = updateUserProfileDto.getAvatar();
    if (StringUtils.hasText(avatar) && avatar.contains("temp/"))
    {
        UploadFileMetaVo uploadFileMetaVo = ossFileService.moveTempToFormal(avatar);
        avatar = uploadFileMetaVo.getUrl();

        //根据当前用户和头像来源查找文件记录，存在则更新，不存在则新增
        if (StringUtils.hasText(avatar))
        {
            LambdaQueryWrapper<SysFile> fileQueryWrapper = new LambdaQueryWrapper<>();
            String fileSource = "用户“" + oldSysUser.getUsername() + "”的头像图片";
            fileQueryWrapper.eq(SysFile::getCreateBy, currentUserId)
                    .eq(SysFile::getFileSource, fileSource)
                    .last("LIMIT 1");
            SysFile avatarFile = sysFileService.getOne(fileQueryWrapper);

            if (avatarFile == null) {
                avatarFile = new SysFile();
                avatarFile.setName(uploadFileMetaVo.getName());
                avatarFile.setFileSource(fileSource);
                avatarFile.setFilePath(uploadFileMetaVo.getFilePath());
                avatarFile.setUrl(uploadFileMetaVo.getUrl());
                avatarFile.setSize(uploadFileMetaVo.getSize());
                avatarFile.setMimeType(uploadFileMetaVo.getMimeType());
                avatarFile.setCreateBy(currentUserId);
                sysFileService.save(avatarFile);
            } else {
                avatarFile.setName(uploadFileMetaVo.getName());
                avatarFile.setFileSource(fileSource);
                avatarFile.setFilePath(uploadFileMetaVo.getFilePath());
                avatarFile.setUrl(uploadFileMetaVo.getUrl());
                avatarFile.setSize(uploadFileMetaVo.getSize());
                avatarFile.setMimeType(uploadFileMetaVo.getMimeType());
                avatarFile.setUpdateBy(currentUserId);
                sysFileService.updateById(avatarFile);
            }
        }
    }

    //如果头像发生变化，删除OSS上的旧头像
    String oldAvatar = oldSysUser.getAvatar();
    if (StringUtils.hasText(avatar) && StringUtils.hasText(oldAvatar)
            && !avatar.equals(oldAvatar)) {
        try {
            ossFileService.deleteFileByUrl(oldAvatar);
            log.info("从oss中删除旧头像成功: {}", oldAvatar);
        } catch (Exception e) {
            log.warn("从oss中删除旧头像失败: {}, 错误: {}", oldAvatar, e.getMessage()); //删除失败不影响更新流程，只记录日志
        }
    }

    //使用LambdaUpdateWrapper条件更新
    LambdaUpdateWrapper<SysUser> wrapper = new LambdaUpdateWrapper<SysUser>()
            .eq(SysUser::getId, currentUserId)
            .set(SysUser::getNickname, updateUserProfileDto.getNickname())
            .set(SysUser::getSex, updateUserProfileDto.getSex())
            .set(SysUser::getAvatar, avatar);

    boolean success = update(null, wrapper);
    if (!success) {
        return ResponseResult.errorResult(AppHttpCodeEnum.SYSTEM_ERROR, "更新用户信息失败");
    }

    //如果头像或昵称发生变化，同步更新评论表中该用户的所有评论
    boolean avatarChanged = !Objects.equals(avatar, oldSysUser.getAvatar());
    boolean nicknameChanged = !Objects.equals(updateUserProfileDto.getNickname(), oldSysUser.getNickname());

    if (avatarChanged || nicknameChanged) {
        LambdaUpdateWrapper<Comment> commentWrapper =
                new LambdaUpdateWrapper<Comment>()
                        .eq(Comment::getUserId, currentUserId);

        if (avatarChanged) {
            commentWrapper.set(Comment::getAvatar, avatar);
        }
        if (nicknameChanged) {
            commentWrapper.set(Comment::getNickname, updateUserProfileDto.getNickname());
        }

        commentMapper.update(null, commentWrapper);
    }

    return ResponseResult.okResult();
}

---

---

---

---

PS:该系列只做为作者学习开发项目做的笔记用

不一定符合读者来学习，仅供参考

---

预告

后续会记录博客的开发过程

每次学习会做一份笔记来进行发表

“一花一世界，一叶一菩提”

---

版权所有 © 2026 云梦泽
欢迎访问我的个人网站：https://hgt12.github.io/