NextJS构建外部类型失效：无法识别服务端types模块

核心问题分析 #

你遇到的类型错误本质是服务端TypeScript配置错误忽略了类型文件夹，导致编译时无法识别src/types下导出的Controller类型，同时需要确认类型文件的导出结构是否正确。

具体修复步骤 #

1. 修正服务端tsconfig的exclude配置 #

服务端tsconfig.json的exclude数组里错误包含了src/types，这会让TypeScript完全跳过该文件夹的类型解析，直接导致import type { Controller } from "types"找不到对应导出。

修改服务端tsconfig.json的exclude部分：

"exclude": ["node_modules", "build"] // 移除"src/types"

2. 确保服务端类型文件的导出结构正确 #

在server/src/types文件夹下，需要有一个入口文件（通常是index.ts或index.d.ts）来导出Controller类型，示例：

// server/src/types/index.ts
export type Controller = {
  // 填写你的Controller类型定义
};

如果Controller是在单独文件（比如controller.d.ts）中定义的，可以在index.ts中统一导出：

// server/src/types/index.ts
export type { Controller } from './controller';

这样import "types"就能正确解析到src/types/index.ts的导出内容。

3. 验证服务端路径解析配置 #

服务端tsconfig.json的baseUrl设置为./src，所以import "types"会直接指向src/types文件夹的入口文件，这个配置本身是正确的，只要完成前两步就能正常识别类型。

4. 客户端类型引用的补充验证 #

客户端tsconfig.json中已经通过include包含了../server/src/types，并且通过paths配置了@server/*指向服务端源码，若客户端需要引用服务端类型，可使用：

import type { Controller } from '@server/types';

确保客户端也能正确获取服务端类型定义，实现端到端类型安全。

验证修复 #

完成上述步骤后，重新执行构建命令，即可解决Module "types" has no exported member 'Controller'的错误。

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