100 lines
3.8 KiB
Markdown
100 lines
3.8 KiB
Markdown
# 事务配置审计报告
|
||
|
||
## 检查时间
|
||
2025-11-06
|
||
|
||
## 检查范围
|
||
所有服务类中的 `@Transactional` 配置
|
||
|
||
## 检查结果
|
||
|
||
### ✅ 正确配置的服务
|
||
|
||
#### 1. StoryboardVideoService
|
||
- **类级别**: 无 `@Transactional` ✅
|
||
- **createTask**: `@Transactional(propagation = Propagation.REQUIRES_NEW)` ✅
|
||
- 快速保存任务，事务立即提交
|
||
- **processTaskAsync**: `@Async` + `@Transactional(propagation = Propagation.NOT_SUPPORTED)` ✅
|
||
- 在事务外执行，调用外部API不会占用连接
|
||
- **其他方法**: 使用独立的事务方法，快速完成 ✅
|
||
|
||
#### 2. TaskQueueService
|
||
- **类级别**: `@Transactional` ⚠️
|
||
- **processPendingTasks**: `@Transactional(propagation = Propagation.NOT_SUPPORTED)` ✅
|
||
- 覆盖类级别配置，在事务外执行
|
||
- **processTask**: `@Transactional(propagation = Propagation.NOT_SUPPORTED)` ✅
|
||
- 在事务外调用外部API
|
||
- **checkTaskStatuses**: `@Transactional(propagation = Propagation.NOT_SUPPORTED)` ✅
|
||
- 在事务外轮询外部API状态
|
||
- **checkTaskStatusInternal**: `@Transactional(propagation = Propagation.NOT_SUPPORTED)` ✅
|
||
- 在事务外调用外部API
|
||
- **其他方法**: 快速数据库操作，使用独立事务 ✅
|
||
|
||
#### 3. TaskStatusPollingService
|
||
- **类级别**: 无 `@Transactional` ✅
|
||
- **pollTaskStatus**: `@Transactional(propagation = Propagation.NOT_SUPPORTED)` ✅
|
||
- 在事务外轮询外部API
|
||
- **其他方法**: 快速数据库操作，使用独立事务 ✅
|
||
|
||
### ⚠️ 需要关注的服务
|
||
|
||
#### 4. TextToVideoService
|
||
- **类级别**: `@Transactional` ⚠️
|
||
- **createTask**: 继承类级别事务
|
||
- ✅ 只做快速数据库操作（保存任务、添加到队列）
|
||
- ✅ 没有调用外部API
|
||
- ✅ 没有长时间运行的操作
|
||
- **结论**: 虽然使用类级别事务，但方法快速完成，应该没问题
|
||
|
||
#### 5. ImageToVideoService
|
||
- **类级别**: `@Transactional` ⚠️
|
||
- **createTask**: 继承类级别事务
|
||
- ✅ 只做快速数据库操作（保存任务、添加到队列）
|
||
- ✅ 没有调用外部API
|
||
- ✅ 没有长时间运行的操作
|
||
- **结论**: 虽然使用类级别事务，但方法快速完成，应该没问题
|
||
|
||
#### 6. UserWorkService
|
||
- **类级别**: `@Transactional` ⚠️
|
||
- **所有方法**: 都是快速数据库操作
|
||
- ✅ 没有调用外部API
|
||
- ✅ 没有长时间运行的操作
|
||
- **结论**: 应该没问题
|
||
|
||
### 📊 总结
|
||
|
||
#### 长时间运行的方法（已正确配置）
|
||
1. ✅ `StoryboardVideoService.processTaskAsync` - `NOT_SUPPORTED` + `@Async`
|
||
2. ✅ `TaskQueueService.processPendingTasks` - `NOT_SUPPORTED`
|
||
3. ✅ `TaskQueueService.processTask` - `NOT_SUPPORTED`
|
||
4. ✅ `TaskQueueService.checkTaskStatuses` - `NOT_SUPPORTED`
|
||
5. ✅ `TaskQueueService.checkTaskStatusInternal` - `NOT_SUPPORTED`
|
||
6. ✅ `TaskStatusPollingService.pollTaskStatus` - `NOT_SUPPORTED`
|
||
|
||
#### 快速事务方法（已正确配置）
|
||
- ✅ 所有 `readOnly = true` 的方法
|
||
- ✅ 所有独立的 `@Transactional` 方法（快速数据库操作）
|
||
- ✅ `StoryboardVideoService.createTask` - `REQUIRES_NEW`（快速提交）
|
||
|
||
#### 潜在问题
|
||
- ⚠️ `TextToVideoService` 和 `ImageToVideoService` 有类级别 `@Transactional`
|
||
- 但它们的 `createTask` 方法都是快速操作，应该没问题
|
||
- 如果未来需要在这些方法中调用外部API，需要添加 `NOT_SUPPORTED`
|
||
|
||
## 建议
|
||
|
||
### 当前状态
|
||
✅ **所有事务配置都是正确的，应该能正常关闭**
|
||
|
||
### 最佳实践建议
|
||
1. ✅ 长时间运行的方法都使用了 `NOT_SUPPORTED`
|
||
2. ✅ 异步方法都正确配置了 `@Async`
|
||
3. ✅ 快速事务方法都快速完成
|
||
4. ⚠️ 考虑移除 `TextToVideoService` 和 `ImageToVideoService` 的类级别 `@Transactional`，改为方法级别配置，以提高灵活性
|
||
|
||
## 结论
|
||
**✅ 所有事务都能正常关闭，没有发现连接泄漏风险**
|
||
|
||
|
||
|