NextJS(TypeScript)中Next-intl传参报错：INVALID_MESSAGE问题求助

针对你遇到的Error: INVALID_MESSAGE: MALFORMED_ARGUMENT问题，可按以下步骤排查解决：

• 先验证参数值有效性
  暂时将参数替换为硬编码字符串测试：

  {t('app.common.add', { type: '测试分类' })}
  

  如果能正常渲染，说明问题出在t('app.categories.metadata.subcategory')的返回值上。检查对应翻译文件中该key是否存在、是否为有效字符串——若key缺失，next-intl可能返回undefined或key本身，导致参数类型异常。

• 移除不必要的类型断言
  代码中的as never会跳过TypeScript类型检查，可能掩盖参数类型不匹配的问题。直接移除断言，让TS自动校验：

  {t('app.common.add', {
    type: t('app.categories.metadata.subcategory')
  })}
  

  若此时TS报错，说明参数类型不符合预期，可进一步排查翻译文件的类型定义或返回值类型。

• 分离嵌套的翻译调用
  避免在参数中直接嵌套t函数调用，先将子翻译结果存入变量：

  const subcategoryText = t('app.categories.metadata.subcategory');
  // 后续使用
  {t('app.common.add', { type: subcategoryText })}
  

  这种写法能避免嵌套调用时可能出现的上下文或异步加载问题。

• 检查版本兼容性
  确认next-intl版本与当前Next.js版本适配，建议升级到最新稳定版（如v3.x系列）。旧版本可能存在嵌套翻译参数的处理bug，升级后可解决部分兼容性问题。

• 验证消息语法与配置
  确保翻译文件中的Add {{type}}格式正确：双大括号与参数名之间无多余空格，且未使用特殊字符。同时检查layout中的NextIntlClientProvider是否正确传递了messages等配置，保证客户端组件能获取到完整的国际化上下文。

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