Strapi单条collection-type接口携带_locale参数请求返回404问题

问题根因 #

Strapi的本地化机制中，不同语言的同一条内容会生成独立的数据库条目，对应不同的ID：

• 列表接口myApi/projects?_locale=fr会直接过滤所有已发布的法语Project条目，因此可以正常返回结果
• 单条查询接口myApi/projects/[ID]?_locale=fr是直接用ID匹配对应语言下的条目，你传入的1是默认英语条目的ID，不存在对应法语条目时就会返回404

解决方法 #

方法1：使用对应语言的条目ID查询 #

1. 先调用myApi/projects?_locale=fr获取法语Project列表
2. 从列表结果中取你需要的那条法语内容对应的id字段
3. 用该ID发起单条请求：myApi/projects/[法语条目ID]?_locale=fr即可正常返回结果

方法2：通过通用标识过滤查询 #

如果需要通过默认语言的slug、ID等通用标识查询对应本地化内容，可使用列表接口加限制条件模拟单条查询：

• Strapi v4请求示例：myApi/projects?_locale=fr&filters[slug][$eq]=目标项目slug&pagination[limit]=1
• Strapi v3请求示例：myApi/projects?_locale=fr&_where[slug][eq]=目标项目slug&_limit=1

返回结果的第一条就是目标法语内容，效果和单条查询一致。

异常排查 #

如果确认对应法语条目已存在仍返回404，按以下步骤排查：

• 检查角色权限：进入Strapi后台→设置→用户与权限插件→角色，确认你使用的角色（如公共角色）已经开启Project资源的findOne权限
• 确认条目状态：检查目标法语Project条目是否已设置为「已发布」，默认接口仅返回已发布内容，草稿内容需携带参数publicationState=preview才可查询
• 核对参数拼写：确认_locale参数的下划线未遗漏，语言编码和后台配置的本地化编码完全一致（如是否为fr-FR而非fr）

内容的提问来源于stack exchange，提问作者Alexandre