Fastify升级转ES6后遇TypeError: func.toString is not a function求助

这个报错的核心原因是：Fastify在加载插件时，期望传入的是一个插件函数，但实际收到了非函数类型的值（比如undefined、模块对象、普通对象等），导致代码尝试调用func.toString()时失败。你代码里的toString调用和这个报错无关，问题出在插件注册流程中。

结合你从CommonJS转ES6+升级Fastify的场景，以下是常见问题和排查/解决步骤：

1. 检查自定义插件的导出方式 #

CommonJS中通常用module.exports导出插件函数，但ES6模块需要用export default：

• 错误示例（命名导出）：

  // 自定义插件：错误写法
  export const authPlugin = async (fastify, opts) => {
    // 插件逻辑
  };
  

• 正确示例（默认导出）：

  // 自定义插件：正确写法
  export default async (fastify, opts) => {
    // 插件逻辑
  };
  

2. 检查插件注册时的导入逻辑 #

如果是动态导入插件（用await import()），需要确保正确获取默认导出的函数：

• 错误示例（直接使用模块对象）：

  // 错误：import返回的是模块对象，不是插件函数
  const authPlugin = await import('./plugins/auth.js');
  fastify.register(authPlugin);
  

• 正确示例（解构获取default导出）：

  // 正确：获取模块的默认导出
  const { default: authPlugin } = await import('./plugins/auth.js');
  fastify.register(authPlugin);
  

3. 检查第三方插件的导入适配 #

部分第三方插件可能仍以CommonJS格式发布，在ES6模块中导入时，需要确认是否需要手动取.default（部分打包工具如pnpm可能自动处理，但偶尔会有例外）：

// 若导入第三方插件时报错，尝试手动取default
import fastifyCors from '@fastify/cors';
// 如果上述写法不行，改用：
import * as corsModule from '@fastify/cors';
const fastifyCors = corsModule.default;

4. 排查所有fastify.register()调用 #

遍历代码中所有fastify.register()的调用，确认第一个参数绝对是函数类型：

• 避免传入undefined（比如导入路径错误导致模块加载失败）
• 避免传入对象（比如误把插件配置当成插件函数传入）

快速调试技巧 #

可以在每个fastify.register()调用前添加一行检测代码，快速定位问题：

const plugin = ...; // 你的插件导入结果
console.log('插件类型:', typeof plugin); // 必须输出'function'
if (typeof plugin !== 'function') {
  console.error('无效插件:', plugin);
}
fastify.register(plugin);

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