基于Node.js的Angular容器健康检查失效问题排查

1. Alpine镜像默认未安装curl #

node:18-alpine是基于Alpine Linux的轻量镜像，默认不包含curl工具。健康检查命令中执行curl会直接失败，导致健康检查不通过。

解决方法：
在最终的镜像构建阶段添加curl安装命令：

FROM node:18-alpine
WORKDIR /app
# 添加curl安装步骤
RUN apk add --no-cache curl
COPY --from=builder /app/package.json /app
COPY --from=builder /app/dist /app/dist
ENV NODE_ENV=production
EXPOSE 4000
CMD ["npm", "run", "serve:ssr"]

2. 健康检查命令的执行方式问题 #

如果使用字符串形式的test命令，Docker会用/bin/sh -c来执行，可能存在shell解析的潜在问题。可以改用数组形式的命令，避免这类问题：

修改docker-compose.yml中的健康检查配置：

healthcheck:
  test: ["CMD", "curl", "-f", "http://localhost:4000/health"]
  interval: 1m30s
  timeout: 10s
  retries: 3
  start_period: 40s

3. 服务启动延迟与start_period不匹配 #

虽然你设置了start_period: 40s，但Angular SSR服务的启动时间可能超过这个值，导致第一次健康检查在服务完全就绪前执行，进而失败。可以适当延长start_period，比如：

start_period: 1m

4. 服务监听地址的潜在问题（可能性较低） #

如果你的server.ts中服务监听的是127.0.0.1而非0.0.0.0，理论上容器内部的localhost可以访问，但外部能正常访问的话，说明服务应该已经绑定了0.0.0.0。不过可以确认server.ts中的listen代码，确保是：

server.listen(4000, '0.0.0.0', () => {
  console.log('Server listening on port 4000');
});

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