xiaoxia/xiaoxia-saas
1
0
Fork 0
Code Issues 16 Pull Requests Actions Packages Projects Releases 7 Wiki Activity

后端/小程序：getOrCreateDefaultProject 幂等化，禁止重复建默认项目和素材库 #1775

New Issue
Closed
opened 2026-09-07 22:06:10 +08:00 by xiaoxia · 1 comment
xiaoxia commented 2026-09-07 22:06:10 +08:00
Owner
Copy Link
Copy Source

背景

小程序端上传素材时，getOrCreateDefaultProject 在重试、并发或前端重复调用场景下，可能为同一用户重复创建默认项目和默认素材库。仅靠“先查再插”无法保证幂等。

修复要求

  1. 定位 miniapp-bff / 后端中 getOrCreateDefaultProject 及默认素材库创建逻辑。
  2. 同一用户的默认项目必须唯一：使用数据库唯一约束、upsert、事务锁或等价机制保证，不能只依赖应用层先查后插。
  3. 默认项目与默认素材库的创建要在同一事务中完成，或有可靠补偿；并发请求必须返回同一条项目和同一条素材库记录。
  4. 如需增加唯一索引，先检查存量重复数据：
    • staging 的测试重复数据可清理；
    • 生产重复数据只输出清单和合并/清理方案，不自动删除。
  5. 补充并发和重试测试。

验收标准

  • 同一用户连续/并发调用 10 次，只创建 1 个默认项目和 1 个默认素材库。
  • 上传失败重试不会产生第二个空项目/空素材库。
  • 不同用户各自拥有独立默认项目。
  • 唯一约束冲突时接口返回已有记录，不报 500。
  • PR 目标分支为 develop，禁止合并 main。
## 背景 小程序端上传素材时，`getOrCreateDefaultProject` 在重试、并发或前端重复调用场景下，可能为同一用户重复创建默认项目和默认素材库。仅靠“先查再插”无法保证幂等。 ## 修复要求 1. 定位 miniapp-bff / 后端中 `getOrCreateDefaultProject` 及默认素材库创建逻辑。 2. 同一用户的默认项目必须唯一：使用数据库唯一约束、upsert、事务锁或等价机制保证，不能只依赖应用层先查后插。 3. 默认项目与默认素材库的创建要在同一事务中完成，或有可靠补偿；并发请求必须返回同一条项目和同一条素材库记录。 4. 如需增加唯一索引，先检查存量重复数据： - staging 的测试重复数据可清理； - 生产重复数据只输出清单和合并/清理方案，不自动删除。 5. 补充并发和重试测试。 ## 验收标准 - 同一用户连续/并发调用 10 次，只创建 1 个默认项目和 1 个默认素材库。 - 上传失败重试不会产生第二个空项目/空素材库。 - 不同用户各自拥有独立默认项目。 - 唯一约束冲突时接口返回已有记录，不报 500。 - PR 目标分支为 `develop`，禁止合并 `main`。
xiaoxia commented 2026-09-08 11:07:57 +08:00
Author
Owner
Copy Link
Copy Source

已完成。PR #1783（feat: DB 唯一约束兜底）+ PR #1784（fix test）已合并 develop。getOrCreateDefaultProject 改为 upsert，DB 层 unique(user_id, is_default) 兜底防并发。

已完成。PR #1783（feat: DB 唯一约束兜底）+ PR #1784（fix test）已合并 develop。getOrCreateDefaultProject 改为 upsert，DB 层 unique(user_id, is_default) 兜底防并发。
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
P0
阻塞性，必须立即处理
 P1
高优先级
 P2
中优先级
 P3
低优先级/后考虑
 architecture
架构设计
 backend
后端相关
 blocked
阻塞中
 bug
Bug修复
 ci-bug
CI本身的bug
 ci-optimization
CI优化类任务
 ci-pipeline
CI流水线/workflow相关
 cleanup
代码清理
 devops
运维/部署/CI
 documentation
文档相关
 feature
新功能
 frontend
前端相关
 question
需要讨论确认
 ready
PR CI通过，可合并
 refactor
代码重构
No Label
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
auto-approve-bot xiaoxia
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: xiaoxia/xiaoxia-saas#1775
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?