Node/Express如何正确指定证书读取路径及解决Docker部署ENOENT报错

1. 关于COPY . .的拷贝逻辑说明 #

COPY . . 的规则是：将执行docker build命令时所在的构建上下文目录下，所有未被.dockerignore排除的文件，全量拷贝到容器内当前WORKDIR对应的路径（也就是本例中的/usr/src/app）。
正常情况下只要满足两个前提，项目根目录的证书文件是会被成功拷贝进容器的：

• 项目根目录的.dockerignore文件没有将*.pem、key.pem、cert.pem这类证书规则设为排除项（很多团队为了避免敏感证书被打进公开镜像，会主动加这类忽略规则，这是最常见的拷贝遗漏点）
• 执行docker构建命令时，确实是在项目根目录下执行的，没有错把上级目录作为构建上下文

哪怕证书真的被成功拷贝到容器里，原有代码的路径写法也存在根本性的认知错位，这才是报错的核心原因。

2. 原路径写法的错误根源 #

很多开发者写fs模块的相对路径时，会默认「相对路径是基于当前代码文件的存放位置计算」，但实际Node.js的fs模块中，所有相对路径都是基于进程启动时的工作目录（即process.cwd()）计算，和代码文件自身的存放位置完全无关。

对照本例的容器内实际目录结构：

/usr/src/app/  # 容器的WORKDIR，也是node服务启动时的cwd
├─ dist/
│  └─ server.js  # 实际运行的编译后代码
├─ src/
│  └─ server.ts  # 源文件
├─ key.pem
└─ cert.pem

你之前写的../key.pem，按fs的路径解析规则，实际寻找的绝对路径是/usr/src/key.pem——这个路径下根本不存在证书文件，自然会抛出ENOENT错误。
哪怕你误以为相对路径是基于js文件位置计算，这个写法也只在特定假设下成立，但fs根本不遵循这个计算逻辑，从根源上就会出现路径错位。

3. 正确的路径配置方案 #

有两种可靠的配置方式可以彻底解决路径错位问题：

• 方案1：对齐进程工作目录写路径
  因为容器内的工作目录固定为/usr/src/app，证书文件就存放在这个目录下，直接把路径改为./key.pem、./cert.pem即可，此时fs解析出的路径和实际文件位置完全匹配：

  const options = {
    key: fs.readFileSync('./key.pem'),
    cert: fs.readFileSync('./cert.pem')
  };
  

• 方案2：用绝对路径拼接，彻底摆脱cwd影响
  如果担心后续启动服务时的工作目录变化导致路径错位，可以用__dirname（即当前运行的server.js文件所在的绝对路径）来拼接证书路径，不管在哪个目录下启动服务，路径都不会错：

  import fs from 'fs';
  import path from 'path';
  
  const options = {
    // __dirname 指向dist目录，向上跳一级到app根目录匹配证书位置
    key: fs.readFileSync(path.join(__dirname, '../key.pem')),
    cert: fs.readFileSync(path.join(__dirname, '../cert.pem'))
  };
  

快速验证检查点 #

构建镜像后可以临时启动一个容器，执行ls -l /usr/src/app，确认证书文件确实被拷贝到了指定目录，排除.dockerignore导致的拷贝遗漏问题。

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