Docker部署TypeScript Node.js项目无法启动访问应如何处理？

是否需要新增npm build命令生成.js文件 #

分两种场景：

• 生产环境部署：必须新增。ts-node-dev是面向开发场景的工具，内置热重载能力，运行效率低、资源占用高，不适合生产环境使用。通过tsc编译为js文件后用原生node执行，性能更高、稳定性更强，也不需要在生产环境安装TypeScript相关的开发依赖，能大幅减小镜像体积。
• 临时测试场景：可以暂时不新增，但不推荐长期使用该方案。

容器无法访问的解决方案 #

最直接的原因：你执行的启动命令docker run -p 80:3001 testApp是将宿主机的80端口映射到容器的3001端口，此时访问localhost:3001当然无法命中服务，你可以选择两种修改方式：

• 直接访问localhost:80即可打开服务
• 将启动命令修改为docker run -p 3001:3001 testApp，再访问localhost:3001

如果修改端口映射后仍无法访问，排查以下问题：

1. 基础镜像版本过旧 #

你使用的node:10-alpine版本太老，当前主流的TypeScript、ts-node-dev等工具最低支持的Node版本已经升到12+，版本不兼容会导致依赖安装失败、服务启动报错。建议将基础镜像替换为LTS版本，比如node:18-alpine。

2. 工作目录配置不规范 #

你的Dockerfile中WORKDIR /将系统根目录作为工作目录，极易出现权限冲突、文件路径错误的问题，建议修改为WORKDIR /app，所有项目文件都会放到独立的/app目录下，避免路径冲突。

3. 服务监听地址错误 #

检查index.ts中服务的监听地址，必须配置为0.0.0.0，不能配置为127.0.0.1或者localhost。容器内的127.0.0.1只能被容器内部进程访问，宿主机无法请求到该地址，监听0.0.0.0才能接收来自容器外部的请求。

4. 依赖缺失 #

如果你的ts-node-dev是放在package.json的devDependencies中，Node镜像默认的生产环境不会安装开发依赖，会导致启动失败。要么将ts-node-dev移到生产依赖（不推荐），要么切换为编译后运行js的方案。

推荐优化后的配置 #

package.json scripts配置 #

"scripts": {
  "test": "jest",
  "build": "tsc",
  "start": "node ./index.js",
  "dev": "ts-node-dev ./index.ts"
}

Dockerfile配置 #

FROM node:18-alpine

WORKDIR /app

# 提前复制依赖配置，利用Docker缓存加快构建速度
COPY package*.json ./
COPY tsconfig.json ./

RUN npm install

COPY . .

# 编译TypeScript为JavaScript
RUN npm run build

# 移除开发依赖，减小镜像体积
RUN npm prune --production

EXPOSE 3001

CMD ["npm", "start"]

启动命令 #

# 构建镜像
docker build -t testApp .
# 启动容器，映射宿主机3001端口到容器3001端口
docker run -p 3001:3001 testApp

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