Payload v3集合beforeChange钩子修改嵌套对象不生效问题

核心问题：钩子挂载位置错误 #

你把beforeChangeFunc挂在了tab类型字段（relations）的hooks里，而非集合根级的hooks中。Payload v3里，字段级的beforeChange钩子仅能修改当前字段自身的值，无法影响整个文档的其他字段（比如你要修改的content字段）。你在字段级钩子里返回的修改只会作用于relations字段，而非整个文档，所以数据库和afterChange钩子里看不到content的变化。

修复步骤 #

1. 调整钩子挂载位置：将beforeChangeFunc和afterChangeFunc移到集合定义的根级hooks属性下，而非某个tab字段的hooks里：

const CollectionName = {
  slug: "collectionname",
  // 根级hooks，作用于整个文档
  hooks: {
    beforeChange: [beforeChangeFunc],
    afterChange: [afterChangeFunc],
  },
  fields: [
    {
      type: "tabs",
      tabs: [
        {
          label: "Relations",
          name: "relations",
          fields: [
            {
              name: "posts",
              type: "relationship",
              hasMany: true,
              relationTo: "posts",
            },
            {
              name: "people",
              type: "relationship",
              hasMany: true,
              relationTo: "people",
            },
          ],
          // 移除这里的hooks，除非你需要单独处理relations字段本身
          // hooks: {
          //   beforeChange: [beforeChangeFunc],
          //   afterChange: [afterChangeFunc],
          // },
        },
      ],
    },
  ],
};

2. 验证钩子参数：在beforeChangeFunc中确认props.data是整个文档对象，而非单个字段的数据。此时你修改content字段并返回新的文档结构，就能正确同步到数据库和afterChange钩子中。

额外检查点 #

• 确保content字段确实存在于集合的字段定义中（你提供的精简代码里未显示，原代码应该包含），否则Payload会忽略未定义字段的修改。
• 若原代码中有循环逻辑，确认循环对newContent的修改没有遗漏或覆盖——不过你已经通过console.log确认修改后的newContent正确，所以核心问题还是钩子位置错误。

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