Strapi API提交含Dynamic Zone数据的HTTP POST请求的正确格式是什么

你的报错核心原因大概率是以下两点之一：Strapi v4核心API要求请求参数包裹在data字段内，或者你调用的是默认前端注册接口，该接口原生不支持写入自定义字段。

情况1：调用管理员用户创建接口（POST /api/users，需携带管理员身份Token） #

这是最常用的后端创建用户的场景，正确请求体格式如下：

{
  "data": {
    "username": "string",
    "password": "string",
    "email": "string",
    "AdditionalInfo": [
      {
        "__component": "user-type.student-user-infos",
        "address": "string",
        "parentsName": "string",
        "parentsPhoneNumber": "string",
        "schoolName": "string",
        "otherInfo": "string"
      }
    ]
  }
}

需要核对的配置项：

• 组件API ID要和实际配置一致：你可以在Strapi后台「内容类型生成器」找到对应组件，查看顶部显示的API ID，替换上面的user-type.student-user-infos
• 字段名要使用小驼峰格式：Strapi默认会将后台创建的大驼峰字段转为小驼峰，比如后台的ParentsName在API中需写为parentsName
• 确保管理员角色拥有AdditionalInfo动态 zone 及关联组件的读写权限

情况2：调用前端用户注册接口（POST /api/auth/local/register） #

默认的前端注册接口不会处理用户自定义字段，你需要先扩展注册接口逻辑：

1. 在Strapi项目中新建文件src/extensions/users-permissions/strapi-server.js，写入以下代码：

module.exports = (plugin) => {
  const originalRegister = plugin.controllers.auth.register;
  plugin.controllers.auth.register = async (ctx) => {
    const { AdditionalInfo } = ctx.request.body;
    // 先调用原有注册逻辑创建基础用户
    await originalRegister(ctx);
    // 写入动态 zone 自定义数据
    if (ctx.state.user && AdditionalInfo) {
      await strapi.entityService.update('plugin::users-permissions.user', ctx.state.user.id, {
        data: { AdditionalInfo },
        populate: ['AdditionalInfo']
      });
    }
  };
  return plugin;
};

2. 重启Strapi服务后，即可使用你原有格式的请求体调用注册接口：

{
  "username": "string",
  "password": "string",
  "email": "string",
  "AdditionalInfo": [
    {
      "__component": "user-type.student-user-infos",
      "address": "string",
      "parentsName": "string",
      "parentsPhoneNumber": "string",
      "schoolName": "string",
      "otherInfo": "string"
    }
  ]
}

通用排查项 #

如果还是返回400错误，可逐一核对以下内容：

• 组件内所有必填字段都已传值，无遗漏
• 当前调用接口的角色已开放动态 zone、关联组件的读写权限
• 查看Strapi服务端运行日志，会明确返回字段不匹配、权限不足等具体错误原因

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