Strapi控制器BeforeSave/BeforeUpdate中如何向内容管理器UI抛出错误提示

我之前也踩过这个坑！你尝试的errors.push()和strapi.notification.error()在控制器的生命周期钩子里是不会触发后台面板弹窗的，得用Strapi专门的错误处理机制才行。

核心思路：抛出ValidationError #

Strapi的后台管理面板会自动捕获并处理strapi.errors.ValidationError类型的错误，把它转换成用户能看到的弹窗提示，甚至还能关联到表单字段高亮显示。

完整代码示例 #

以下是在beforeCreate和beforeUpdate钩子中添加验证并抛出错误的示例：

module.exports = {
  async beforeCreate(event) {
    const { data } = event.params;

    // 自定义验证逻辑：检查标题长度
    if (!data.title || data.title.trim().length < 5) {
      // 抛出ValidationError，支持关联字段和自定义消息
      throw new strapi.errors.ValidationError('标题长度不能少于5个字符', {
        errors: [
          {
            path: ['title'], // 对应表单里的字段名，后台会高亮这个字段
            message: '标题长度不能少于5个字符',
            name: 'ValidationError',
          },
        ],
      });
    }
  },

  async beforeUpdate(event) {
    const { data } = event.params;

    // 自定义验证逻辑：检查价格不能为负
    if (data.price !== undefined && data.price < 0) {
      throw new strapi.errors.ValidationError('价格不能设置为负数', {
        errors: [
          {
            path: ['price'],
            message: '价格不能为负数',
            name: 'ValidationError',
          },
        ],
      });
    }
  },
};

为什么之前的方法不生效？ #

• errors.push()：这个方式只适用于模型Schema中定义的验证规则，在生命周期钩子里手动push不会被后台面板识别。
• strapi.notification.error()：这是后台插件内部的前端方法，在Node.js环境的控制器钩子里无法直接调用触发前台弹窗。

额外技巧：支持多语言错误消息 #

如果你的项目启用了多语言，可以用i18n键作为错误消息，比如：

throw new strapi.errors.ValidationError('content-manager.error.title-too-short', {
  errors: [
    {
      path: ['title'],
      message: 'content-manager.error.title-too-short',
      name: 'ValidationError',
    },
  ],
});

只需要在admin/src/translations对应的语言文件中添加该键的翻译即可。

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