『博客开发日记』之用户注册接口的实现

本文最后更新于 2026年1月20日 晚上

用户注册接口的实现

用户注册接口的需求

要求用户能够在注册界面完成用户的注册

用户名，昵称，邮箱不能和数据库中原有的数据重复

如果某项重复了注册失败并且要有对应的提示

用户名，密码，昵称，邮箱都不能为空

注意:密码必须密文存储到数据库中

不需要token请求就可以进行注册

下面主要展示服务类的代码

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
@Autowired
private PasswordEncoder passwordEncoder;

@Autowired
private RedisCache redisCache;

//用户注册
@Override
public ResponseResult userRegister(UserRegisterDto dto)
{
    //对用户名和密码进行非空判断
    if (!StringUtils.hasText(dto.getUsername())) {
        return ResponseResult.errorResult(AppHttpCodeEnum.USERNAME_NOT_NULL, "用户名不能为空");
    }
    if (!StringUtils.hasText(dto.getPassword())) {
        return ResponseResult.errorResult(AppHttpCodeEnum.PASSWORD_NOT_NULL, "密码不能为空");
    }

    //验证码不能为空
    if (!StringUtils.hasText(dto.getCode())) {
        return ResponseResult.errorResult(AppHttpCodeEnum.SYSTEM_ERROR, "验证码不能为空");
    }

    //邮箱和手机号至少要有一个
    if (!StringUtils.hasText(dto.getEmail()) && !StringUtils.hasText(dto.getPhone())) {
        return ResponseResult.errorResult(AppHttpCodeEnum.SYSTEM_ERROR, "邮箱和手机号至少填写一个");
    }

    //校验手机号格式
    if (StringUtils.hasText(dto.getPhone()) && !dto.getPhone().matches(PHONE_REGEX)) {
        return ResponseResult.errorResult(AppHttpCodeEnum.PHONE_FORMAT_ERROR, "请输入正确的手机号码");
    }

    //验证验证码
    ResponseResult verifyResult = verifyCode(dto);
    if (verifyResult != null) {
        return verifyResult;
    }

    //用户名，手机号，邮箱不能和数据库中原有的数据重复
    if (StringUtils.hasText(dto.getUsername())) {
        LambdaQueryWrapper<User> queryWrapper = new LambdaQueryWrapper<>();
        queryWrapper.eq(User::getUsername, dto.getUsername());
        User existUser = getOne(queryWrapper);
        if (existUser != null) {
            return ResponseResult.errorResult(AppHttpCodeEnum.USERNAME_OCCUPIED, "用户名已被占用！");
        }
    }
    if (StringUtils.hasText(dto.getPhone())) {
        LambdaQueryWrapper<User> queryWrapper = new LambdaQueryWrapper<>();
        queryWrapper.eq(User::getPhone, dto.getPhone());
        User existUser = getOne(queryWrapper);
        if (existUser != null) {
            return ResponseResult.errorResult(AppHttpCodeEnum.PHONE_OCCUPIED, "该手机号已被注册！");
        }
    }
    if (StringUtils.hasText(dto.getEmail())) {
        LambdaQueryWrapper<User> queryWrapper = new LambdaQueryWrapper<>();
        queryWrapper.eq(User::getEmail, dto.getEmail());
        User existUser = getOne(queryWrapper);
        if (existUser != null) {
            return ResponseResult.errorResult(AppHttpCodeEnum.EMAIL_OCCUPIED, "该邮箱已被注册！");
        }
    }

    //创建用户对象
    User user = new User();
    user.setUsername(dto.getUsername());
    user.setEmail(dto.getEmail());
    user.setPhone(dto.getPhone());

    //密码必须密文存储到数据库中
    String encodePassword = passwordEncoder.encode(dto.getPassword());
    user.setPassword(encodePassword);

    //如果没有设置昵称，使用用户名作为默认昵称
    if (StringUtils.hasText(dto.getNickname())) {
        user.setNickname(dto.getNickname());
    } else {
        user.setNickname(dto.getUsername());
    }

    //存入数据库
    save(user);
    return ResponseResult.okResult("注册成功");
}

//验证注册验证码
private ResponseResult verifyCode(UserRegisterDto dto)
{
    String code = dto.getCode();
    String redisKey;
    String account;

    // 判断是邮箱注册还是手机注册
    if (StringUtils.hasText(dto.getEmail())) {
        account = dto.getEmail();
        redisKey = "register:code:email:" + account;
    } else if (StringUtils.hasText(dto.getPhone())) {
        account = dto.getPhone();
        redisKey = "register:code:phone:" + account;
    } else {
        return ResponseResult.errorResult(AppHttpCodeEnum.SYSTEM_ERROR, "邮箱和手机号至少填写一个");
    }

    // 从Redis获取验证码
    String redisCode = redisCache.getCacheObject(redisKey);

    // 验证码不存在或已过期
    if (!StringUtils.hasText(redisCode)) {
        return ResponseResult.errorResult(AppHttpCodeEnum.VERIFICATION_CODE_ERROR, "验证码错误或已过期");
    }

    // 验证码错误
    if (!code.equals(redisCode)) {
        return ResponseResult.errorResult(AppHttpCodeEnum.VERIFICATION_CODE_ERROR, "验证码错误");
    }

    // 验证通过，立即删除Redis中的验证码（防止重复使用）
    redisCache.deleteObject(redisKey);

    return null;
}

注意注册时还需要获取验证码才能注册

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

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

预告

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

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

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

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

博客开发
#技术向 #个人博客 #前端 #后端
『博客开发日记』之用户注册接口的实现
http://example.com/2026/01/19/『博客开发日记』之用户注册接口的实现/
作者
云梦泽
发布于
2026年1月19日
更新于
2026年1月20日
许可协议