Docker容器已安装json-server仍提示command not found的问题排查

两阶段构建的核心特性是每个FROM指令对应完全独立的镜像层环境，不同阶段的文件、安装的软件、系统配置完全隔离，你当前的配置出现命令找不到的问题，本质是三个连锁问题叠加：

• 你在第一阶段（build-step对应的node:10-alpine环境）执行的npm install -g json-server，所有安装的命令文件、软链接、依赖包都只存在于第一阶段的镜像层中；第二阶段是全新的nginx:1.17.1-alpine基础镜像，除了你主动通过COPY --from=build-step拷贝的前端静态文件，没有继承第一阶段的任何安装内容，自然找不到json-server命令。
• json-server是基于Node.js开发的工具，第二阶段的nginx-alpine镜像本身没有预装Node.js运行时，就算把json-server的命令文件拷贝过去，缺少运行环境也无法启动。
• 你在CMD中引用的services/mock-api/db.json、services/mock-api/routes.json这两个mock接口资源文件，从来没有被拷贝到第二阶段的镜像中，就算解决了命令找不到的问题，后续也会因为找不到接口配置文件报错。

你现在的需求是在部署前端静态资源的同时，在同网络环境下提供mock API服务，根据运维习惯可以选两种实现路径：

路径1：单容器同时运行nginx和json-server #

不拆分容器，在第二阶段的运行镜像里配齐所有依赖，通过进程管理器同时拉起两个服务：

1. 在第二阶段的nginx镜像基础上，安装Node.js运行环境、json-server、轻量进程管理工具（比如supervisor）
2. 把mock服务需要的db.json、routes.json从构建阶段拷贝到运行镜像的对应路径
3. 配置进程管理器，同时启动nginx和json-server两个服务（如果直接用CMD单独启动json-server，会覆盖镜像默认的nginx启动流程，导致前端静态服务无法运行）
   参考修正后的Dockerfile片段：

   # 最终运行阶段
   FROM nginx:1.17.1-alpine
   # 安装依赖：nodejs跑json-server，supervisor做进程管理
   RUN apk add --no-cache nodejs npm supervisor \
       && npm install -g json-server
   # 原有静态资源和配置拷贝
   COPY nginx.conf /etc/nginx/nginx.conf
   COPY --from=build-step /app/dist/my-app /usr/share/nginx/html
   # 拷贝mock服务需要的配置文件
   COPY --from=build-step /app/services/mock-api /app/services/mock-api
   # 配置文件里定义同时启动nginx和json-server的规则
   COPY supervisord.conf /etc/supervisord.conf
   CMD ["supervisord", "-c", "/etc/supervisord.conf"]
   

路径2：拆分为两个独立容器服务 #

这种方式更符合Docker单一服务单容器的设计原则，也更容易维护：

• 原来的nginx镜像只负责托管前端静态资源，移除所有和json-server相关的配置
• 单独构建一个专门运行json-server的镜像，基于Node.js基础镜像制作，内置db.json和路由配置文件
• 两个容器通过自定义Docker网络打通，前端业务代码直接请求json-server容器的服务地址即可，不需要把两个进程塞在同一个容器中

• 不要尝试直接把第一阶段全局安装的json-server文件从构建层拷贝到运行层，因为node:10-alpine和nginx:1.17.1-alpine的底层系统库版本存在差异，跨层拷贝很容易出现动态链接库缺失的运行报错，不如直接在运行层重新安装json-server稳定。
• 生产环境下运行json-server不需要加--watch参数，这个参数是为了本地开发时热更新db.json用的，生产环境开启反而会增加无意义的资源消耗。

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