TypeScript编译的JS文件独立运行失效、仅dist目录下可正常运行问题

问题根因定位 #

你的故障核心原因是相对路径解析逻辑和静态资源缺失，和Docker本身无关，是TypeScript项目编译后部署的常见问题，具体原因及解决方法如下：

1. 相对路径引用错误 #

这是最高概率的触发原因：

• 你代码中大概率使用了相对于工作目录的相对路径加载资源（比如加载命令文件的fs.readdirSync('./commands')、读取配置文件的require('./config.json')等写法）
• 你在文件夹1中执行node dist/index.js时，工作目录是项目根目录，相对路径会指向项目根目录下的对应文件，所以运行正常
• 你把dist下的js文件移到文件夹2根目录后执行node index.js，工作目录变成文件夹2的根目录，相对路径找不到对应资源，相关功能直接失效

修复方法：
所有资源引用的路径改为基于当前JS文件所在目录的绝对路径，用__dirname拼接即可，示例：

// 错误写法：相对于执行node命令的工作目录
const commandFiles = fs.readdirSync('./commands').filter(file => file.endsWith('.js'))
// 正确写法：相对于当前ts文件编译后的js文件所在目录
const commandFiles = fs.readdirSync(path.join(__dirname, 'commands')).filter(file => file.endsWith('.js'))

2. 非TS类型资源未同步到dist目录 #

tsc编译只会处理.ts后缀的文件，你项目中用到的.json配置、命令元数据、静态模板等非TS文件，默认不会被输出到dist目录：

• 你在文件夹1运行时，项目根目录存在这些静态文件，路径正确的前提下可以正常读取
• 你只拷贝dist目录下的编译产物到文件夹2时，缺失了这些静态资源，导致功能异常

修复方法：
在yarn build命令中添加静态资源拷贝逻辑，示例：

// package.json的script字段修改
"build": "tsc --build && cp -r src/**/*.json src/**/*.yml dist/"

如果资源目录结构复杂，也可以用copyfiles等第三方工具处理批量拷贝。

3. Dockerfile路径配置优化 #

你当前的Dockerfile存在目录结构不一致的问题，建议调整如下：

FROM node:16 AS builder

WORKDIR /usr/src/app
COPY package.json yarn.lock ./
RUN yarn install --frozen-lockfile
COPY . .
RUN yarn build

FROM node:16 AS production-prepare

WORKDIR /usr/src/app
COPY --from=builder /usr/src/app/package.json /usr/src/app/yarn.lock ./
# 保留dist目录结构，不要把内容直接拷到根目录
COPY --from=builder /usr/src/app/dist ./dist
RUN yarn install --production --frozen-lockfile

FROM gcr.io/distroless/nodejs:16
WORKDIR /app
COPY --from=production-prepare /usr/src/app ./

CMD ["dist/index.js"]

快速排查技巧 #

如果调整后仍有问题，可以先把最终镜像替换为普通的node:16镜像，在启动前添加日志打印所有资源加载的绝对路径，对比本地运行和容器运行的路径差异，即可快速定位问题点。

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