Next.js导出函数遇Type '(thingId:string)=>Promise<void>'不可赋值给never错误

可能的原因及排查方向 #

1. 特殊文件的模块约定冲突 #

Next.js对路由相关文件（如page.tsx、layout.tsx）有严格的导出规则，这类文件要求导出符合对应路由类型的内容（比如页面组件）。如果你的异步函数写在这类特殊文件里，导出的函数不符合文件预期的类型，就会被TypeScript推断为never，触发类型不兼容错误。

2. 全局类型声明覆盖 #

检查项目中的全局类型文件（如global.d.ts）或第三方类型依赖，是否存在意外将导出函数类型覆盖为never的情况。可以临时注释全局类型文件，观察错误是否消失，以此定位问题来源。

3. TypeScript配置影响 #

查看tsconfig.json的配置项：

• 检查strict模式是否开启，严格模式下类型推断逻辑更严格，可能导致隐式never的异常推断。
• 确认noImplicitReturns、noImplicitAny等规则是否干扰了函数返回值的类型判断，尽管你的函数已经明确是Promise<void>，但极端配置可能引发类型检查器的异常。

4. 多导出内容的类型合并冲突 #

如果该文件同时导出了其他符合特定类型的内容（比如路由组件），TypeScript可能会尝试合并所有导出内容的类型，最终推断出never类型。可以尝试将该函数单独导出到一个普通工具文件（如utils.ts），验证错误是否重现。

5. 依赖版本bug #

部分旧版本的Next.js或其配套类型包（如@types/react、@types/node）存在类型定义bug，可能导致导出非路由内容时出现异常。尝试升级相关依赖版本，观察问题是否解决。

快速验证步骤 #

• 将函数移至普通工具文件（非路由约定文件）导出，检查错误是否消失。
• 显式强化函数返回类型（尽管代码已声明，但可再次明确）：

  export async function doThing(thingId: string): Promise<void> {
    await fetch(
      new URL('http://server/doThing/'+thingId),
      {
        method: 'POST',
      }
    )
  }
  

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