1
controller
2
mapper
3
model
4
service
5
utils

1
/**
2
 * 用于测试UserService类 * * @author ShineAcZ
3
 * @date 2025/12/24
4
 */@SpringBootTest
5
class UserServiceTest {
6

7
    @Resource
8
    UserService userService;
9

10
    @Test
11
    void testAddUser(){
12
        User user = new User();
13

14
        user.setUsername("testUser");
15
        user.setUserAccount("123");
16
        user.setAvatarUrl("https://tuchuang-1353351309.cos.ap-guangzhou.myqcloud.com/picture/20250904232225476.png");
17
        user.setGender(0);
18
        user.setUserPassword("xxx");
19
        user.setPhone("123");
20
        user.setEmail("456");
21

22
        boolean result = userService.save(user);
23
        System.out.println(user.getId());
24
        Assertions.assertTrue(result);
25
    }
26
}

1
/**
2
 * 启动类 * */
3
@SpringBootApplication
4
// 要记得添加这个注解来扫描mapper里的全部类
5
@MapperScan("top.shineacz.usercenter.mapper")
6
public class UserCenterApplication {
7

8
    public static void main(String[] args) {
9
        SpringApplication.run(UserCenterApplication.class, args);
10
    }
11

12
}

1
package top.shineacz.usercenter.controller;
2

3
import org.apache.commons.lang3.StringUtils;
4
import org.springframework.web.bind.annotation.PostMapping;
5
import org.springframework.web.bind.annotation.RequestBody;
6
import org.springframework.web.bind.annotation.RequestMapping;
7
import org.springframework.web.bind.annotation.RestController;
8
import top.shineacz.usercenter.model.domain.User;
9
import top.shineacz.usercenter.model.domain.request.UserLoginRequest;
10
import top.shineacz.usercenter.model.domain.request.UserRegisterRequest;
11
import top.shineacz.usercenter.service.UserService;
12

13
import javax.annotation.Resource;
14
import javax.servlet.http.HttpServletRequest;
15

16
/**
17
 * 用户接口层 * * @author ShineAcZ
18
 * @date 2025/12/28
19
 */@RestController
20
@RequestMapping("/user")
21
public class UserController {
22

23
    @Resource
24
    UserService userService;
25

26
    @PostMapping("/register")
27
    public long userRegister(@RequestBody UserRegisterRequest userRegisterRequest){
28
        if(userRegisterRequest == null) return -1;
29

30
        String userAccount = userRegisterRequest.getUserAccount();
31
        String userPassword = userRegisterRequest.getUserPassword();
32
        String checkPassword = userRegisterRequest.getCheckPassword();
33

34
        if(StringUtils.isAnyBlank(userAccount,userPassword,checkPassword))return -1;
35

36
        return userService.userRegister(userAccount, userPassword, checkPassword);
37
    }
38

39
    @PostMapping("/login")
40
    public User userLogin(@RequestBody UserLoginRequest userLoginRequest, HttpServletRequest request){
41
        if(userLoginRequest == null) return null;
42

43
        String userAccount = userLoginRequest.getUserAccount();
44
        String userPassword = userLoginRequest.getUserPassword();
45

46
        if(StringUtils.isAnyBlank(userAccount,userPassword)) return null;
47

48
        return userService.userLogin(userAccount, userPassword, request);
49
    }
50
}

1
spring:
2
  # session 失效时间 24小时
3
  session:
4
    timeout: 86400

1
serve:
2
  port: 8080
3
  servlet:
4
    context-path: /api

1
/**
2
 * 自定义全局业务异常 * * @author ShineAcZ
3
 * @date 2026/1/5
4
 */@Getter
5
public class BusinessException extends RuntimeException {
6

7
    private int code;
8
    private String description;
9

10
    // 定义构造函数
11

12
    public BusinessException(String message, int code, String description) {
13
        super(message);
14
        this.code = code;
15
        this.description = description;
16
    }
17

18
    public BusinessException(ErrorCode errorCode) {
19
        super(errorCode.getMessage());
20
        this.code = errorCode.getCode();
21
        this.description = errorCode.getDescription();
22
    }
23
    public BusinessException(ErrorCode errorCode,  String description) {
24
        super(errorCode.getMessage());
25
        this.code = errorCode.getCode();
26
        this.description = description;
27
    }
28

29
}

1
        if (userRegisterRequest == null) {
2
//            return ResultUtils.error(ErrorCode.PARAMS_ERROR);
3
            throw new BusinessException(ErrorCode.PARAMS_ERROR);
4
        }

1
// 1.校验
2
// 是否有任意一个为空(使用了commons.lang3库) 也可以使用Hutools的StrUtils.hasBlank
3
if (StringUtils.isAnyBlank(userAccount, userPassword, checkPassword)) {
4
    throw new BusinessException(ErrorCode.PARAMS_ERROR,"参数为空");
5
}
6
// 账号是否小于4位
7
if (userAccount.length() < 4) {
8
    throw new BusinessException(ErrorCode.PARAMS_ERROR,"账号不能小于4位");
9
}
10
// 密码是否小于8位
11
if (userPassword.length() < 8 || checkPassword.length() < 8) {
12
    throw new BusinessException(ErrorCode.PARAMS_ERROR,"密码不能小于8位");
13
}
14
// 密码和校验密码不相同
15
if (!userPassword.equals(checkPassword)) {
16
    throw new BusinessException(ErrorCode.PARAMS_ERROR,"密码和校验密码不相同");
17
}
18
// 星球编号不大于5位
19
if (planetCode.length() > 5){
20
    throw new BusinessException(ErrorCode.PARAMS_ERROR,"星球编号不能大于5位");
21
}
22

23
// 账号不能包含特殊字符 只允许字母数字下划线
24
String regex = "^[a-zA-Z0-9_]+$";
25

26
if (!Pattern.matches(regex, userAccount)) {
27
    throw new BusinessException(ErrorCode.PARAMS_ERROR,"账号不能包含特殊字符");
28
}

1
/**
2
 * 全局异常处理类 * * @author ShineAcZ
3
 * @date 2026/1/5
4
 */@RestControllerAdvice
5
@Slf4j
6
public class GlobalExceptionHandler {
7

8
    @ExceptionHandler(BusinessException.class)
9
    public <T> BaseResponse<T> businessExceptionHandler(BusinessException e){
10
        log.error("BusinessException:" + e.getMessage(), e);
11
        return ResultUtils.error(e.getCode(), e.getMessage(), e.getDescription());
12

13
    }
14

15
    @ExceptionHandler(RuntimeException.class)
16
    public <T> BaseResponse<T> RuntimeExceptionHandler(RuntimeException e){
17
        log.error("RuntimeException", e);
18
        return ResultUtils.error(ErrorCode.SYSTEM_ERROR, "");
19
    }
20

21
}

1
# ==================== 主配置上下文（main context）====================
2
# 这一部分配置在文件最外层，对整个Nginx服务生效
3

4
# 定义运行Nginx工作进程的用户和用户组
5
# 默认使用"nginx"或"www-data"，实际应根据系统用户设置
6
user nginx;
7

8
# 定义工作进程的数量。通常设置为CPU核心数或auto（自动检测）
9
# 高并发场景可以设置为CPU核心数的倍数（如 worker_processes 8;）
10
worker_processes auto;
11

12
# 定义错误日志文件的位置和日志级别
13
# 日志级别：debug, info, notice, warn, error, crit（严重性递增）
14
# 生产环境通常用 error 或 warn
15
error_log /var/log/nginx/error.log notice;
16

17
# 定义存储Nginx主进程ID的文件位置
18
pid /var/nginx/nginx.pid;
19

20
# ==================== 事件模块配置（events context）====================
21
# 配置影响Nginx服务器与用户的网络连接
22
events {
23
    # 每个worker进程能同时处理的最大连接数（包括与客户端的连接和后端服务器的连接）
24
    # 这个值直接影响Nginx的并发能力。理论最大连接数 = worker_processes * worker_connections
25
    worker_connections 1024;
26

27
    # 使用epoll高效I/O模型（Linux系统推荐）
28
    # 在FreeBSD系统上则使用kqueue，Windows没有
29
    use epoll;
30

31
    # 开启多连接接受模式，允许worker进程同时接受多个新连接
32
    multi_accept on;
33
}
34

35
# ==================== HTTP模块配置（http context）====================
36
# 这是Nginx作为HTTP服务器的核心配置区域
37
http {
38
    # 包含MIME类型定义文件。MIME类型告诉浏览器如何处理不同类型的文件
39
    # 例如：text/html, application/javascript, image/png 等
40
    include /etc/nginx/mime.types;
41

42
    # 默认的MIME类型。如果请求的文件没有匹配到任何MIME类型，则使用这个
43
    default_type application/octet-stream;
44

45
    # 开启高效文件传输模式（零拷贝技术）
46
    # 文件传输会尽量使用直接内存访问，减少在内核态和用户态之间的数据拷贝
47
    sendfile on;
48

49
    # 配合sendfile使用。当连接保持活跃时，允许在一个连接中发送多个文件
50
    tcp_nopush on;
51

52
    # 保持连接的超时时间。客户端完成最后一次请求后，连接保持打开的时间
53
    # 在这段时间内如果有新请求，可以复用这个连接，避免重复建立TCP连接
54
    keepalive_timeout 65;
55

56
    # 启用gzip压缩，减少传输数据量
57
    gzip on;
58
    # gzip压缩级别，1-9，数字越大压缩率越高但CPU消耗越大。通常4-6是平衡点
59
    gzip_comp_level 5;
60
    # 最小压缩文件大小，小于这个值不压缩（避免小文件压缩后反而更大）
61
    gzip_min_length 256;
62
    # 压缩类型，这些类型的文件适合压缩
63
    gzip_types
64
        application/atom+xml
65
        application/javascript
66
        application/json
67
        application/ld+json
68
        application/manifest+json
69
        application/rss+xml
70
        application/vnd.geo+json
71
        application/vnd.ms-fontobject
72
        application/x-font-ttf
73
        application/x-web-app-manifest+json
74
        application/xhtml+xml
75
        application/xml
76
        font/opentype
77
        image/bmp
78
        image/svg+xml
79
        image/x-icon
80
        text/cache-manifest
81
        text/css
82
        text/plain
83
        text/vcard
84
        text/vnd.rim.location.xloc
85
        text/vtt
86
        text/x-component
87
        text/x-cross-domain-policy;
88

89
    # ==================== 服务器块配置（server context）====================
90
    # 这是虚拟主机配置，每个server块可以配置一个网站/应用
91
    # 可以包含多个server块来配置多个网站
92

93
    server {
94
        # 监听端口和绑定的主机名（IP地址）
95
        # 监听80端口，IPv4和IPv6的所有地址
96
        listen 80;
97
        listen [::]:80;
98

99
        # 服务器的域名。当通过这个域名访问时，这个server块生效
100
        # 可以有多个，用空格分隔
101
        server_name localhost;
102

103
        # 网站根目录，即存放HTML/CSS/JS等文件的位置
104
        root /usr/share/nginx/html;
105

106
        # 默认索引文件。当访问目录时，Nginx会按顺序查找这些文件
107
        index index.html index.htm;
108

109
        # ==================== 位置块配置（location context）====================
110
        # 针对特定URL路径的详细配置
111
        # location [匹配模式] { ... }
112

113
        # 匹配所有请求（最通用，优先级最低）
114
        location / {
115
            # 尝试访问请求的文件，如果不存在则返回404错误
116
            try_files $uri $uri/ =404;
117
        }
118

119
        # 错误页面配置。当发生特定HTTP错误时，返回自定义页面
120
        error_page 404 /404.html;
121
        error_page 500 502 503 504 /50x.html;
122

123
        # 定义50x错误页面的位置
124
        location = /50x.html {
125
            root /usr/share/nginx/html;
126
        }
127

128
        # 禁止访问 .htaccess 等隐藏文件（Apache配置文件）
129
        location ~ /\.ht {
130
            deny all;
131
        }
132

133
        # 静态文件缓存配置示例（通常在单独配置文件中）
134
        # location ~* \.(jpg|jpeg|png|gif|ico|css|js)$ {
135
        #     expires 30d;  # 浏览器缓存30天
136
        #     add_header Cache-Control "public, immutable";
137
        # }
138
    }
139

140
    # ==================== 包含其他配置文件 ====================
141
    # 引入其他配置文件，实现配置模块化
142
    # 通常会把虚拟主机配置放在 /etc/nginx/conf.d/ 或 /etc/nginx/sites-enabled/
143
    include /etc/nginx/conf.d/*.conf;
144
    # include /etc/nginx/sites-enabled/*;  # Ubuntu/Debian常用
145
}