Docker部署Angular+Json-Server时json-server命令未找到问题

问题分析 #

你遇到的json-server: not found错误，本质是sh的环境变量PATH中没有包含json-server的安装路径。通过apt-get安装的nodejs/npm，全局安装的工具默认路径可能不在容器默认的PATH里；另外你的Dockerfile中还有一个指令顺序错误，会导致Angular静态文件无法正确部署。

修复步骤 #

1. 修正Dockerfile指令顺序 #

COPY --from=CervantesJuradoBuild指令放在CMD之后，构建阶段不会执行这个复制操作，导致Nginx无法加载Angular的静态文件。需要将这条指令移到CMD之前：

# ... 前面的指令保持不变 ...

USER root

EXPOSE 22 80 3000

# 先复制Angular构建产物到Nginx目录
COPY --from=CervantesJuradoBuild /appContainer/dist/a-animals /usr/share/nginx/html

# 再设置启动命令
CMD ["sh", "-c", "json-server --watch /home/$name/animals.json --host 0.0.0.0 & service ssh start && nginx -g 'daemon off;'"]

2. 解决json-server路径问题（二选一） #

方法一：直接使用json-server的绝对路径执行

在Dockerfile中添加一行确认安装路径的指令，构建时会输出具体路径：

RUN npm install -g json-server
# 查看json-server的绝对路径
RUN which json-server

构建镜像时会输出类似/usr/local/bin/json-server的路径，将CMD中的json-server替换为这个绝对路径：

CMD ["sh", "-c", "/usr/local/bin/json-server --watch /home/$name/animals.json --host 0.0.0.0 & service ssh start && nginx -g 'daemon off;'"]

方法二：将npm全局bin目录加入PATH环境变量

在安装完json-server后，将npm全局工具的路径添加到PATH中：

RUN npm install -g json-server
# 获取npm全局prefix并加入PATH
ENV PATH="$PATH:$(npm config get prefix)/bin"

这样sh就能自动找到json-server命令，无需修改CMD中的指令。

3. 可选：升级nodejs版本（避免兼容性问题） #

apt-get默认安装的nodejs版本可能偏旧，建议换成和构建阶段一致的node18版本，减少潜在问题：

# 替换原来的apt安装nodejs/npm的指令
RUN apt-get update && \
    apt-get install -y openssh-server curl && \
    # 安装node18的源
    curl -fsSL https://deb.nodesource.com/setup_18.x | bash - && \
    apt-get install -y nodejs npm

验证修复 #

重新构建镜像并运行容器，然后通过docker logs cervantes_container查看日志，确认无json-server: not found错误，同时检查Angular应用和json-server是否正常运行。

内容的提问来源于stack exchange，提问作者antonio cervantes jurado