Node.js使用fs模块读取本地同目录zip报ENOENT错误及Linux适配方案问询
报错根因
- 相对路径解析基准错配:Node.js的fs模块处理相对路径时,从来不是基于当前执行的.js文件所在目录解析,而是基于进程启动时的工作目录(cwd)拼接路径。不管你写的是
'exampleLambda.zip'还是'./exampleLambda.zip',本质都走cwd的相对路径逻辑。只要你不是在.js文件的存放目录下敲node 你的文件.js启动进程,或者Linux服务器上用pm2、systemd托管服务时的cwd和代码目录不一致,哪怕两个文件物理上放在同一个文件夹,也会报ENOENT找不到文件的错。 - 跨平台大小写规则不兼容:Windows本地文件系统对文件名大小写不敏感,但Linux是严格按大小写匹配文件名的。比如你实际磁盘上的文件是
examplelambda.zip,代码里写的是exampleLambda.zip,Windows下能正常读,部署到Linux直接就报文件不存在。 - 部署链路的文件遗漏:如果后续用webpack、pkg这类工具打包Node.js项目,默认配置不会把同目录的静态zip文件打进产物里,部署到Linux服务器时目标路径下根本没有这个zip文件,自然也会触发同样的报错。
适配Linux环境的落地方案
- 用内置路径工具构造稳定绝对路径:通过
__dirname(当前.js文件所在目录的绝对路径)和内置path模块拼接目标文件路径,从根源上规避启动工作目录变化带来的路径问题,本地开发、Linux生产环境都能直接用,不需要改配置。示例代码:const fs = require('fs'); const path = require('path'); // 拼接得到zip文件的绝对路径,不受启动目录影响 const zipFilePath = path.join(__dirname, 'exampleLambda.zip'); // 读取文件为Base64格式,直接匹配Lambda createFunction接口的参数要求 const zipContents = fs.readFileSync(zipFilePath, 'base64'); - 加前置存在性校验,提前排错:读取文件前先判断路径下的文件是否存在,一旦出错直接输出实际解析到的路径,快速定位问题。示例代码:
部署到Linux后如果仍报错,通过输出的路径就能快速排查是文件没上传、文件名大小写写错,还是路径拼接逻辑有问题。if (!fs.existsSync(zipFilePath)) { throw new Error(`找不到目标zip文件,实际解析路径为: ${zipFilePath}`); } - 部署流程适配规则:在Linux服务器上用pm2、systemd托管服务时,不需要额外修改服务的cwd配置,上面基于
__dirname的写法可以直接兼容所有启动场景;如果用单文件打包工具把代码打包成可执行文件,需要额外配置将zip文件输出到和可执行文件同目录的位置,确保运行时__dirname指向的路径下存在目标文件。
内容的提问来源于stack exchange,提问作者August Dev
相关产品推荐
相关产品推荐

