本文分析Node.js项目打包后Express无法访问静态文件（如index.html）的问题。通过源码追踪，发现express.static将相对路径转换为基于当前工作目录（process.cwd()）的绝对路径，导致打包后路径失效。推荐使用全局变量__dirname结合path.resolve构建绝对路径，确保开发环境与生产环境路径一致，解决静态资源加载失败问题。
Node.js打包后静态资源访问失败现象
近期公司开展了一个后端基于Node.js的开发项目。在准备向客户演示的打包阶段，同事尝试将之前的3D机房打包工具迁移过来。然而，打包后的项目出现了访问异常，具体表现为首页无法加载。
错误提示为：can not get file index.html
涉及核心模块：express.static
问题根源排查
该Node.js后端使用了Express框架，而index.html属于静态文件。Express框架提供了内置中间件express.static，用于便捷地托管图片、CSS、JavaScript等静态资源。
只需将包含静态资源的目录路径作为参数传递给express.static中间件，即可实现对该目录下静态文件的访问。例如，若将图片、CSS和JavaScript文件存放在public目录中，可配置如下代码：
app.use(express.static('public'));
检查项目代码，发现static方法的调用方式与上述示例高度相似：
app.use(express.static('public'));定位问题后，我告知同事此处使用相对路径存在隐患，建议修改以解决该问题。鉴于打包时间紧迫，先采取临时措施完成打包，后续再深入梳理思路。
app.use(express.static('resource/public'));此类问题并不复杂，深入钻研源码即可快速定位。因此，建议同事自行反思并改进。
确认此处仍使用了相对目录。后续产品迭代中将优化为更稳健的路径处理方式。
express.static源码解析与路径转换机制
深入解析express.static方法
实际上，当向express.static传入相对路径时，Express内部会将其转换为绝对路径。通过查阅Express源码，可找到相关实现：
exports.static = require('serve-static');这表明static调用了serve-static包。进一步查看该包的index.js文件，关键代码如下：
...
var resolve = require('path').resolve
...
opts.root = resolve(root)
...上述两行代码展示了Express将相对目录转换为绝对目录的逻辑，核心依赖于Node.js内置的path对象的resolve方法。
path.resolve方法与当前工作目录原理
深入理解path对象的resolve方法
参考Node.js官方API文档：https://nodejs.org/api/path.html#path_path_resolve_paths
该方法的功能描述如下：
The path.resolve() method resolves a sequence of paths or path segments into an absolute path.
这意味着该方法将一系列路径或路径片段组合解析为一个绝对路径。例如：
path.resolve('/foo','bar');
// return /foo/bar
详细用法请参考官方文档，但需注意以下关键说明：
If after processing all given path segments an absolute path has not yet been generated, the current working directory is used.
其含义是：如果处理完所有给定的路径片段后仍未生成绝对路径，则使用当前工作目录（current working directory）。例如：
path.resolve('bar');
// 加上 /Users/terry 是当前工作目录， return /Users/terry/bar
官方文档提供了一个较复杂的示例（注意resolve方法从右向左处理，具体逻辑参考文档）：
path.resolve('wwwroot', 'static_files/png/', '../gif/image.gif');
// if the current working directory is /home/myself/node,
// this returns '/home/myself/node/wwwroot/static_files/gif/image.gif'
现在的关键问题是：什么是当前工作目录？
当前工作目录与__dirname的区别
Node.js当前工作目录（current working directory）的定义
Node.js的当前工作目录是指启动Node进程时所在的目录。即从哪个目录执行node命令，该目录即为当前工作目录。
需要注意的是，这个目录并非JavaScript文件所在的目录。
可以通过process.cwd()方法获取当前工作目录。
通过以下示例说明当前工作目录的概念：假设在/Users/terry/Documents/JSWorkspace目录下编写一个名为test.js的文件，代码仅有一行：
console.log(process.cwd());
如果在目录/Users/terry/Documents/JSWorkspace下执行命令：node test.js，输出结果如下：
/Users/terry/Documents/JSWorkspace
但如果从目录/Users/terry/Documents/下执行命令：node ./JSWorkspace/test.js，输出结果为：
/Users/terry/Documents由此可见，执行node命令时所在的目录即为当前工作目录。
回到打包问题：开发阶段通常在JavaScript文件所在目录下直接执行node命令，因此相对路径（相对于JS文件）通常能正常工作。
然而，打包后Node的执行环境可能移至JS目录的上一层。此时，相对路径“public”不再相对于JS文件，而是相对于上一层目录，导致无法找到该文件夹及其中的index.html文件。
解决静态资源路径问题的方案
解决方案探讨
解决方法如下：
1. 修改相对路径。如前所述，这种方法较为局限。因为启动Node命令的目录可能变化，若修改路径，开发环境的执行命令也需同步调整，兼容性较差。
2. 使用绝对路径。但不同机器上的绝对路径不同，如何解决？可考虑使用全局变量__dirname。
关于全局变量__dirname
参考API文档：https://nodejs.org/api/modules.html#modules_dirname
官方解释如下：
The directory name of the current module. This is the same as the path.dirname() of the __filename。
这意味着该变量返回当前Node.js JavaScript文件所在的目录。
利用该变量，可通过以下代码解决路径问题：
app.use(express.static(__dirname + '/public'));本文内容旨在帮助开发者理解并解决Node.js静态资源路径问题，欢迎参考与实践。