Strapi无法通过REST API获取SINGLE-TYPE内容的JSON数据

问题场景 #

• 项目使用Strapi作为后端支撑全链路数据流转，创建了关联多个不同组件的SINGLE-TYPE（单类型）内容模型
• 完成全部单类型配置后，通过REST API拉取对应数据时，接口未返回预期的JSON格式响应
• 实际收到的JSON响应截图：
  
• 配置完成的单类型内容结构截图：
  

排查&修复方案 #

1. 检查接口权限配置 #

Strapi默认所有内容接口都开启权限校验，新建单类型未授权的情况下，接口会返回权限错误、空响应或者结构异常的结果：

• 进入Strapi后台「设置」-「用户与权限插件」-「角色」
• 选中接口调用时使用的角色：公开无登录调用选Public，登录态调用选Authenticated
• 在权限列表找到对应单类型，勾选find权限，保存配置后重试请求。

2. 检查单类型发布状态与字段完整性 #

• Strapi默认开启内容发布流程，仅保存草稿未点击「发布」的内容，不会在正式接口返回
• 如果单类型关联的组件内存在未填充的必填字段，内容无法成功发布，接口拉取时会出现数据异常
• 进入单类型内容编辑页，补全所有必填字段（含关联组件内的必填项），确认内容状态为「已发布」后重试。

3. 检查接口请求路径与参数 #

• 单类型的REST API默认路径规则为/api/[单类型的API ID]，注意和集合类型区分：单类型路径为单数形式，不需要拼接内容ID，集合类型默认是复数路径
• 例：单类型API ID为global-config时，正确请求路径为GET /api/global-config，错误写法包括/api/global-configs、/api/global-config/1
• 单类型关联的组件、关联媒体/内容默认不会随基础字段返回，需要携带populate参数拉取嵌套数据，全量拉取可使用请求：GET /api/global-config?populate=*

4. 检查请求头与自定义中间件 #

• 确认接口请求头的Accept字段值为application/json，错误的Accept头会导致Strapi返回非JSON格式响应
• 如果项目自定义过Strapi响应中间件、开启了额外的安全拦截插件，先临时关闭自定义拦截逻辑，测试默认接口是否能返回正常结构，排查是否是自定义逻辑篡改了响应格式。

内容的提问来源于stack exchange，提问作者Abhijeet John Kujur