Strapi REST API无法返回默认语言环境数据问题求助

问题场景 #

• 使用Strapi 4.5.2，已配置两个语言环境：
  • 英文（en）：默认语言，isDefault: true
  • 德语（de）：非默认，isDefault: false
• API请求异常表现：
  • 请求 GET /api/i18n/locales 返回正常语言列表
  • 请求 GET /api/mycollection（不带locale参数）返回空数据：

    {
      "data": [],
      "meta": {
        "pagination": {
          "page": 1,
          "pageSize": 25,
          "pageCount": 0,
          "total": 0
        }
      }
    }
    

  • 请求 GET /api/mycollection?locale=de 可正常返回德语内容
  • 请求 GET /api/mycollection?locale=all 仅返回德语内容
• 后台验证：全局i18n插件配置、集合类型页面及条目均显示英文内容已存在

排查及解决步骤 #

1. 确认英文条目是否已发布 #

Strapi未发布的草稿内容不会通过API对外返回，哪怕后台能看到内容：

• 进入后台英文条目编辑页，右上角确认状态为已发布（绿色标识），而非草稿或待发布状态
• 若为草稿，点击发布按钮后重新测试API

2. 检查集合类型的i18n配置 #

进入 Settings → Content-Type Builder → 目标集合 页面：

• 确认该集合已开启「Internationalization」开关
• 排查是否有字段设置了仅特定语言可见，导致英文内容的字段无法被API读取

3. 验证多语言条目关联关系 #

Strapi的多语言内容通过关联绑定，关联缺失会导致API识别异常：

• 打开德语条目编辑页，查看右侧「Localizations」区域，确认已关联对应的英文条目
• 同理检查英文条目是否关联了德语条目，确保双向关联正确

4. 数据库层面验证英文条目状态 #

直接查看对应数据库表（如SQLite/PostgreSQL）：

• 找到集合对应的数据表（例如mycollection），筛选locale为en的条目
• 确认published_at字段不为空（已发布状态），且条目ID的关联关系正常
• 若数据库中无en条目，说明后台显示的内容未真正保存，尝试重新创建并发布英文条目

5. 重启Strapi服务清除缓存 #

Strapi的配置或内容缓存可能导致生效延迟：

• 重启Strapi服务，清除服务器缓存
• 前端清除浏览器缓存后重新发起API请求

6. 检查角色权限配置 #

进入 Settings → Users & Permissions Plugin → Roles：

• 找到对应访问角色（如Public），确认该角色对目标集合的find权限已开启
• 排查权限是否设置了语言过滤限制，导致默认语言内容被拦截

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