opt:readme优化

This commit is contained in:
2026-04-16 14:14:24 +08:00
parent 993f6ffe45
commit e25e0bdbed
5 changed files with 2 additions and 144 deletions

View File

@@ -430,42 +430,9 @@ log.error("创建设备失败, id: {}, error: {}", id, e.getMessage(), e);
---
## 10. 测试规范
## 10. 部署与发布
### 10.1 单元测试
```java
@SpringBootTest
class DeviceServiceTest {
@Autowired
private IDeviceService deviceService;
@Test
void testCreate() {
DeviceDto dto = new DeviceDto();
dto.setName("测试设备");
dto.setCode("TEST001");
deviceService.create(dto);
DeviceDto result = deviceService.getById(1L);
assertEquals("测试设备", result.getName());
}
}
```
### 10.2 测试覆盖率
- 核心业务逻辑覆盖率 ≥ 80%
- 工具类覆盖率 ≥ 90%
- 新增代码必须有对应的单元测试
---
## 11. 部署与发布
### 11.1 配置管理
### 10.1 配置管理
```bash
# 开发环境
@@ -474,64 +441,3 @@ java -jar nlsso-server.jar --spring.profiles.active=dev
# 生产环境
java -jar nlsso-server.jar --spring.profiles.active=prod
```
### 11.2 启动脚本
```bash
#!/bin/bash
APP_NAME=nlsso-server
APP_DIR=/opt/app
cd $APP_DIR
# 停止旧进程
PID=$(ps -ef | grep $APP_NAME | grep -v grep | awk '{print $2}')
if [ -n "$PID" ]; then
kill -9 $PID
sleep 2
fi
# 启动新进程
nohup java -jar $APP_DIR/$APP_NAME.jar --spring.profiles.active=prod > /dev/null 2>&1 &
echo "服务已启动"
```
---
## 12. 常见问题
### 12.1 依赖冲突
问题:启动时报 `NoSuchMethodError`
解决方案:检查 `pom.xml` 中的依赖版本,使用 `mvn dependency:tree` 分析依赖树,排除冲突的依赖。
### 12.2 数据库连接失败
问题:无法连接数据库
解决方案:
1. 检查数据库服务是否启动
2. 检查 `application.yml` 中的数据库配置
3. 检查数据库用户名和密码
### 12.3 Redis 连接失败
问题:缓存操作失败
解决方案:
1. 检查 Redis 服务是否启动
2. 检查 Redis 配置(主机、端口、密码)
3. 检查防火墙规则
### 12.4 权限不足
问题:访问接口时返回 403
解决方案:
1. 检查用户是否登录
2. 检查用户是否具有相应权限
3. 检查权限配置是否正确
---