Strapi中Content Manager与REST API返回条目ID不一致问题求助

问题现象 #

• 后台Content Manager面板显示的产品ID（如69）与REST API返回的ID（如71）不匹配
• 调用购物车接口时，传入API返回的ID（71）返回null，手动传入后台显示的ID（69）可正常识别产品

已尝试操作 #

• 发现社区存在同类问题案例，但未找到可行解决方案
• 自行排查两天未解决，项目代码已开源托管

可能原因及排查步骤 #

1. 软删除数据导致ID偏移 #

Strapi默认启用软删除（通过deleted_at字段标记），被删除的条目ID不会被复用，后台Content Manager默认隐藏软删除数据，但数据库自增ID仍会累加。

• 排查：直接查询数据库产品表，查看对应产品的真实id字段，确认后台显示值与API返回值哪个是数据库实际ID；同时检查是否存在已软删除的条目占用了中间ID（如70）。

2. 自定义控制器/服务篡改ID字段 #

若项目中自定义了产品的控制器或服务，可能在返回数据时错误修改了id字段。

• 排查：检查src/api/product/controllers/product.js和src/api/product/services/product.js中的代码，确认是否存在类似以下错误逻辑：

  // 错误示例：返回关联资源ID而非产品自身ID
  return { id: entry.related_resource.id, ...entry };
  

3. 数据库自增序列异常 #

手动插入数据或数据库操作异常可能导致自增序列与实际条目ID不匹配，API返回的是序列生成的ID，而后台显示的是数据库中真实存在的ID。

• 排查：
  • MySQL：执行SELECT AUTO_INCREMENT FROM information_schema.TABLES WHERE TABLE_SCHEMA = 'your_db_name' AND TABLE_NAME = 'products';，对比结果与表中最大id值
  • PostgreSQL：执行SELECT nextval('products_id_seq');，对比结果与表中最大id值

4. 插件/自定义逻辑的ID映射问题 #

若使用了多租户、本地化或自定义ID生成插件，可能导致前后台使用不同的ID字段（如local_id与global_id）。

• 排查：检查项目插件配置及自定义模型代码，确认是否存在ID字段的映射或替换逻辑。

修复建议 #

• 若为自定义控制器篡改ID：修正代码，确保返回的是产品模型自身的id字段
• 若为数据库序列异常：重置自增序列至当前表中最大ID值（如MySQL执行ALTER TABLE products AUTO_INCREMENT = [max_id + 1];）
• 若为软删除导致混淆：确保API查询时过滤软删除数据（Strapi默认自动过滤，自定义查询需添加filters: { deleted_at: null }）

内容的提问来源于stack exchange，提问作者Giang Nguyễn Đăng Trường