NextJS Server API读取data目录文件失败，如何确保其纳入构建？

核心原因：Next.js的构建静态分析机制 #

Next.js在构建服务器端代码（包括pages/api下的路由）时，依赖静态代码分析判断哪些文件/目录需要打包到最终服务器产物中。如果代码里没有显式通过路径引用某个目录，构建工具（Webpack）会默认认为该目录无用，不会将其纳入构建结果。

之前出错的根源 #

你最初直接用相对路径（比如./data/file.txt）读取文件时，代码里没有明确生成指向项目根目录下data文件夹的完整路径，Next.js的静态分析没检测到这个目录的存在，构建时根本没把data目录打包进去。运行API路由时，服务器环境找不到该目录，自然抛出ENOENT错误。

path.join(process.cwd(), 'data')的作用 #

1. 路径的确定性：process.cwd()返回你执行npm run build或npm run dev时的项目根目录路径，用它拼接data目录能生成绝对、可靠的路径，避免了相对路径在运行时工作目录不一致的问题。
2. 触发静态分析识别：当你在代码里显式写出path.join(process.cwd(), 'data')时，Next.js的构建工具能通过静态分析识别到这个路径对应的目录，从而将整个data目录纳入服务器构建产物中。这样运行时API路由就能正常读取目录里的文件，而且你不需要提前导入所有文件，完全符合按需读取的需求。

额外补充 #

在Next.js的API路由运行环境中，当前工作目录（.）并不是固定的项目根目录，而是构建后的产物目录，所以直接用相对路径读取文件本身就存在路径偏移的问题。用process.cwd()拼接路径既能解决静态分析的识别问题，又能保证路径的正确性。

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