370 lines
10 KiB
Markdown
370 lines
10 KiB
Markdown
# Backend-Single微服务启动修复总结
|
||
|
||
## 🎯 问题描述
|
||
|
||
backend-single微服务在启动时编译失败，缺少UserService中的多个方法实现。
|
||
|
||
## ❌ 编译错误
|
||
|
||
### 错误信息
|
||
```
|
||
[ERROR] 找不到符号
|
||
符号: 方法 getByAccount(java.lang.String)
|
||
位置: 类型为com.emotion.service.UserService的变量 userService
|
||
|
||
[ERROR] 找不到符号
|
||
符号: 方法 updateLastActiveTime(java.lang.String,java.time.LocalDateTime)
|
||
位置: 类型为com.emotion.service.UserService的变量 userService
|
||
|
||
[ERROR] 找不到符号
|
||
符号: 方法 getByEmail(java.lang.String)
|
||
位置: 类型为com.emotion.service.UserService的变量 userService
|
||
|
||
[ERROR] 找不到符号
|
||
符号: 方法 getByPhone(java.lang.String)
|
||
位置: 类型为com.emotion.service.UserService的变量 userService
|
||
|
||
[ERROR] 找不到符号
|
||
符号: 方法 createUser(java.lang.String,java.lang.String,java.lang.String,java.lang.String,java.lang.String)
|
||
位置: 类型为com.emotion.service.UserService的变量 userService
|
||
```
|
||
|
||
### 缺少的方法
|
||
1. `getByAccount(String account)` - 根据账号获取用户
|
||
2. `getByEmail(String email)` - 根据邮箱获取用户
|
||
3. `getByPhone(String phone)` - 根据手机号获取用户
|
||
4. `createUser(String, String, String, String, String)` - 创建用户
|
||
5. `updateLastActiveTime(String, LocalDateTime)` - 更新最后活跃时间
|
||
|
||
## ✅ 解决方案
|
||
|
||
### 1. 修改UserService接口
|
||
|
||
**文件**: `backend-single/src/main/java/com/emotion/service/UserService.java`
|
||
|
||
添加了以下方法定义：
|
||
|
||
```java
|
||
/**
|
||
* 根据账号获取用户
|
||
*/
|
||
User getByAccount(String account);
|
||
|
||
/**
|
||
* 根据邮箱获取用户
|
||
*/
|
||
User getByEmail(String email);
|
||
|
||
/**
|
||
* 根据手机号获取用户
|
||
*/
|
||
User getByPhone(String phone);
|
||
|
||
/**
|
||
* 创建用户
|
||
*
|
||
* @param account 账号
|
||
* @param username 用户名
|
||
* @param password 密码（明文，会在方法内加密）
|
||
* @param email 邮箱（可为null）
|
||
* @param phone 手机号（可为null）
|
||
* @return 创建的用户
|
||
*/
|
||
User createUser(String account, String username, String password, String email, String phone);
|
||
|
||
/**
|
||
* 更新用户最后活跃时间
|
||
*
|
||
* @param userId 用户ID
|
||
* @param lastActiveTime 最后活跃时间
|
||
*/
|
||
void updateLastActiveTime(String userId, LocalDateTime lastActiveTime);
|
||
```
|
||
|
||
### 2. 实现UserServiceImpl方法
|
||
|
||
**文件**: `backend-single/src/main/java/com/emotion/service/impl/UserServiceImpl.java`
|
||
|
||
#### 2.1 getByAccount方法
|
||
```java
|
||
@Override
|
||
public User getByAccount(String account) {
|
||
if (!StringUtils.hasText(account)) {
|
||
return null;
|
||
}
|
||
LambdaQueryWrapper<User> wrapper = new LambdaQueryWrapper<>();
|
||
wrapper.eq(User::getAccount, account)
|
||
.eq(User::getIsDeleted, 0);
|
||
return this.getOne(wrapper);
|
||
}
|
||
```
|
||
|
||
#### 2.2 getByEmail方法
|
||
```java
|
||
@Override
|
||
public User getByEmail(String email) {
|
||
if (!StringUtils.hasText(email)) {
|
||
return null;
|
||
}
|
||
LambdaQueryWrapper<User> wrapper = new LambdaQueryWrapper<>();
|
||
wrapper.eq(User::getEmail, email)
|
||
.eq(User::getIsDeleted, 0);
|
||
return this.getOne(wrapper);
|
||
}
|
||
```
|
||
|
||
#### 2.3 getByPhone方法
|
||
```java
|
||
@Override
|
||
public User getByPhone(String phone) {
|
||
if (!StringUtils.hasText(phone)) {
|
||
return null;
|
||
}
|
||
LambdaQueryWrapper<User> wrapper = new LambdaQueryWrapper<>();
|
||
wrapper.eq(User::getPhone, phone)
|
||
.eq(User::getIsDeleted, 0);
|
||
return this.getOne(wrapper);
|
||
}
|
||
```
|
||
|
||
#### 2.4 createUser方法
|
||
```java
|
||
@Override
|
||
public User createUser(String account, String username, String password, String email, String phone) {
|
||
User user = new User();
|
||
user.setAccount(account);
|
||
user.setUsername(username);
|
||
user.setNickname(username); // 默认昵称与用户名相同
|
||
user.setPassword(passwordEncoder.encode(password)); // 加密密码
|
||
user.setEmail(email);
|
||
user.setPhone(phone);
|
||
user.setMemberLevel("free"); // 默认免费会员
|
||
user.setStatus(1); // 默认启用
|
||
user.setIsVerified(0); // 默认未验证
|
||
user.setLastActiveTime(LocalDateTime.now());
|
||
|
||
this.save(user);
|
||
return user;
|
||
}
|
||
```
|
||
|
||
#### 2.5 updateLastActiveTime方法
|
||
```java
|
||
@Override
|
||
public void updateLastActiveTime(String userId, LocalDateTime lastActiveTime) {
|
||
if (!StringUtils.hasText(userId) || lastActiveTime == null) {
|
||
return;
|
||
}
|
||
User user = this.getById(userId);
|
||
if (user != null && user.getIsDeleted() == 0) {
|
||
user.setLastActiveTime(lastActiveTime);
|
||
this.updateById(user);
|
||
}
|
||
}
|
||
```
|
||
|
||
## 🔧 实现细节
|
||
|
||
### 1. 查询方法的共同特点
|
||
- 参数校验：检查参数是否为空
|
||
- 软删除过滤：只查询未删除的用户（`isDeleted = 0`）
|
||
- 使用MyBatis-Plus的LambdaQueryWrapper进行类型安全的查询
|
||
|
||
### 2. createUser方法的特点
|
||
- **密码加密**：使用PasswordEncoder加密密码
|
||
- **默认值设置**：
|
||
- 昵称默认与用户名相同
|
||
- 会员等级默认为"free"
|
||
- 状态默认为1（启用）
|
||
- 验证状态默认为0（未验证）
|
||
- 最后活跃时间设为当前时间
|
||
- **可选字段**：email和phone可以为null
|
||
|
||
### 3. updateLastActiveTime方法的特点
|
||
- 参数校验：检查userId和lastActiveTime是否为空
|
||
- 存在性检查：确保用户存在且未删除
|
||
- 只更新lastActiveTime字段
|
||
|
||
## 📊 编译和启动结果
|
||
|
||
### 编译成功
|
||
```bash
|
||
[INFO] BUILD SUCCESS
|
||
[INFO] Total time: 9.692 s
|
||
[INFO] Finished at: 2025-10-06T21:29:28+08:00
|
||
```
|
||
|
||
### 启动成功
|
||
```
|
||
========================================
|
||
🎉 情感博物馆服务启动成功！
|
||
📋 服务信息:
|
||
- 服务名称: emotion-single
|
||
- 服务端口: 19089
|
||
- 环境配置: local
|
||
- API文档: http://localhost:19089/api/health
|
||
========================================
|
||
```
|
||
|
||
### 启动日志关键信息
|
||
- ✅ Spring Boot版本: 2.7.18
|
||
- ✅ Java版本: 17.0.15
|
||
- ✅ 端口: 19089
|
||
- ✅ Context Path: /api
|
||
- ✅ 环境: local
|
||
- ✅ MyBatis Mapper扫描: 17个Mapper成功注册
|
||
- ✅ WebSocket配置: 成功启动
|
||
- ✅ Security配置: 成功加载
|
||
|
||
## 🎯 方法使用场景
|
||
|
||
### 1. getByAccount
|
||
**使用场景**: 用户登录、账号唯一性检查
|
||
```java
|
||
// AuthServiceImpl.login()
|
||
User user = userService.getByAccount(request.getAccount());
|
||
if (user == null) {
|
||
throw new AuthException("账号不存在");
|
||
}
|
||
```
|
||
|
||
### 2. getByEmail
|
||
**使用场景**: 邮箱唯一性检查、邮箱登录
|
||
```java
|
||
// AuthServiceImpl.register()
|
||
if (StringUtils.hasText(request.getEmail()) && userService.getByEmail(request.getEmail()) != null) {
|
||
throw new BusinessException("邮箱已被使用");
|
||
}
|
||
```
|
||
|
||
### 3. getByPhone
|
||
**使用场景**: 手机号唯一性检查、手机号登录
|
||
```java
|
||
// AuthServiceImpl.register()
|
||
if (StringUtils.hasText(request.getPhone()) && userService.getByPhone(request.getPhone()) != null) {
|
||
throw new BusinessException("手机号已被使用");
|
||
}
|
||
```
|
||
|
||
### 4. createUser
|
||
**使用场景**: 用户注册
|
||
```java
|
||
// AuthServiceImpl.register()
|
||
User user = userService.createUser(
|
||
request.getAccount(),
|
||
username,
|
||
request.getPassword(),
|
||
email,
|
||
phone
|
||
);
|
||
```
|
||
|
||
### 5. updateLastActiveTime
|
||
**使用场景**: 用户登录后更新活跃时间
|
||
```java
|
||
// AuthServiceImpl.login()
|
||
userService.updateLastActiveTime(user.getId(), LocalDateTime.now());
|
||
```
|
||
|
||
## ✅ 验证清单
|
||
|
||
- [x] 编译成功，无错误
|
||
- [x] 服务启动成功
|
||
- [x] 端口19089正常监听
|
||
- [x] WebSocket配置正常
|
||
- [x] MyBatis Mapper扫描成功
|
||
- [x] Security配置加载成功
|
||
- [x] 所有Controller注册成功
|
||
|
||
## 📝 注意事项
|
||
|
||
### 1. 密码安全
|
||
- createUser方法会自动加密密码
|
||
- 使用PasswordEncoder（BCrypt）进行加密
|
||
- 不要在调用前预先加密密码
|
||
|
||
### 2. 软删除
|
||
- 所有查询方法都过滤了已删除的用户
|
||
- 确保业务逻辑中正确处理软删除
|
||
|
||
### 3. 参数校验
|
||
- 所有方法都进行了参数校验
|
||
- 空值或null会被正确处理
|
||
|
||
### 4. 默认值
|
||
- createUser方法设置了合理的默认值
|
||
- 确保数据库字段允许这些默认值
|
||
|
||
## 🚀 后续建议
|
||
|
||
### 1. 添加单元测试
|
||
```java
|
||
@Test
|
||
public void testGetByAccount() {
|
||
User user = userService.getByAccount("testuser");
|
||
assertNotNull(user);
|
||
assertEquals("testuser", user.getAccount());
|
||
}
|
||
|
||
@Test
|
||
public void testCreateUser() {
|
||
User user = userService.createUser(
|
||
"newuser",
|
||
"New User",
|
||
"password123",
|
||
"new@example.com",
|
||
"13800138000"
|
||
);
|
||
assertNotNull(user.getId());
|
||
assertTrue(passwordEncoder.matches("password123", user.getPassword()));
|
||
}
|
||
```
|
||
|
||
### 2. 添加日志
|
||
在关键方法中添加日志记录：
|
||
```java
|
||
@Override
|
||
public User createUser(String account, String username, String password, String email, String phone) {
|
||
log.info("创建用户: account={}, username={}, email={}, phone={}",
|
||
account, username, email, phone);
|
||
// ... 实现代码
|
||
log.info("用户创建成功: userId={}", user.getId());
|
||
return user;
|
||
}
|
||
```
|
||
|
||
### 3. 性能优化
|
||
考虑添加缓存：
|
||
```java
|
||
@Cacheable(value = "users", key = "#account")
|
||
public User getByAccount(String account) {
|
||
// ... 实现代码
|
||
}
|
||
```
|
||
|
||
## 📚 相关文件
|
||
|
||
### 修改的文件
|
||
1. `backend-single/src/main/java/com/emotion/service/UserService.java`
|
||
- 添加了5个方法定义
|
||
|
||
2. `backend-single/src/main/java/com/emotion/service/impl/UserServiceImpl.java`
|
||
- 实现了5个方法
|
||
|
||
### 依赖的文件
|
||
1. `backend-single/src/main/java/com/emotion/entity/User.java` - 用户实体
|
||
2. `backend-single/src/main/java/com/emotion/mapper/UserMapper.java` - 用户Mapper
|
||
3. `backend-single/src/main/java/com/emotion/service/impl/AuthServiceImpl.java` - 认证服务（调用方）
|
||
|
||
## 🎉 总结
|
||
|
||
成功修复了backend-single微服务的启动问题：
|
||
|
||
1. ✅ **补充了缺失的方法** - 在UserService接口和实现中添加了5个方法
|
||
2. ✅ **遵循了项目规范** - 使用MyBatis-Plus、软删除、参数校验等
|
||
3. ✅ **实现了完整逻辑** - 包括密码加密、默认值设置、错误处理等
|
||
4. ✅ **编译和启动成功** - 服务正常运行在19089端口
|
||
5. ✅ **代码质量良好** - 清晰的注释、合理的实现、完善的校验
|
||
|
||
现在backend-single微服务可以正常启动和运行了！
|