Strapi v5 ID非连续递增引发数据NotFound问题求助

问题详情 #

• Strapi v5 中出现ID非连续递增情况，且Strapi后台界面显示与MySQL数据库实际数据存在差异：
  Strapi后台界面显示：
  
  MySQL数据库显示：
  
• 通过Postman访问接口http://localhost:1337/api/cates/3时返回404错误，响应内容：

{
    "data": null,
    "error": {
        "status": 404,
        "name": "NotFoundErro]",
        "message": "Not Found",
        "details": 1
    }
}

• 该问题在Strapi v4中未出现

解决步骤 #

1. 排查软删除机制 #

Strapi v5默认开启软删除功能，被标记为删除的数据在后台界面不可见，但数据库中仍保留（deleted_at字段有值），这会导致ID看似不连续，且访问已软删除的ID会返回404。

• 操作：
  • 进入cates内容类型的设置页面，查看高级设置里的软删除开关
  • 若不需要软删除，直接关闭该功能；若需要保留，可在请求时添加?withDeleted=true参数查询已删除数据，比如http://localhost:1337/api/cates/3?withDeleted=true

2. 同步数据与缓存 #

Strapi v5的查询缓存优化可能导致后台界面显示与数据库不同步。

• 操作：
  • 重启Strapi服务，清除应用缓存
  • 执行数据库同步命令（注意：此操作会清空现有数据，务必先备份！）：

    npm run strapi db:migrate:fresh
    

3. 处理MySQL自增ID #

MySQL自增ID因事务回滚、数据删除等出现不连续是正常现象，但如果业务依赖连续ID可手动调整：

• 操作：
  • 执行SQL语句重置自增序列：

    ALTER TABLE cates AUTO_INCREMENT = (SELECT MAX(id) + 1 FROM cates);
    

  • 建议尽量避免业务逻辑依赖ID连续性，这会影响数据库性能和扩展性

4. 检查API路由配置 #

确认cates的API路由未被自定义逻辑覆盖：

• 操作：
  • 打开src/api/cates/routes/cates.js文件，检查默认的GET /api/cates/:id路由是否存在且未被修改
  • 若有自定义路由，确认其优先级和逻辑是否冲突

内容的提问来源于stack exchange，提问作者Cường Hoàng Kim