Docker Node容器启动失败求助：npm不在$PATH路径中

核心原因 #

你在docker-compose的环境变量里直接覆盖了PATH，仅添加了本地node_modules的bin目录，导致系统默认PATH被替换，容器找不到全局安装的npm命令（node官方镜像中npm位于系统默认PATH路径内）。另外entrypoint: []虽然解决了之前的docker-entrypoint.sh not found错误，但也让容器直接执行command，叠加PATH覆盖的问题就触发了npm找不到的报错。

具体修复方案 #

方案1：修正PATH环境变量 #

不要直接覆盖PATH，而是在原有系统PATH基础上追加本地依赖的bin目录：

environment:
  NODE_VERSION: ${NODE_VERSION:-alpine}
  NODE_ENV: development
  PATH: $PATH:/usr/src/app/node_modules/.bin

这样既保留了系统默认PATH（包含npm的路径），又能优先使用本地项目依赖的命令。

方案2：移除自定义PATH设置 #

如果你的项目不需要优先调用本地node_modules内的命令，直接删掉docker-compose里的PATH环境变量即可，容器会沿用Dockerfile构建时的默认PATH，npm就能正常被找到。

方案3：使用npm绝对路径执行命令 #

如果必须保留当前PATH配置，可以直接用npm的绝对路径执行命令。在node:22-alpine镜像中，npm的默认路径是/usr/local/bin/npm，修改docker-compose的command：

command: [ "/usr/local/bin/npm", "run", "dev" ]

额外注意事项 #

• 你当前挂载了本地./frontend到容器的/usr/src/app，这会覆盖容器构建阶段安装的node_modules（Dockerfile里的RUN npm install是在镜像内完成的，挂载本地目录后会替换容器内对应路径的内容）。如果本地未安装依赖，后续可能触发其他报错，建议取消注释docker-compose里的- /usr/src/app/node_modules挂载项，让容器使用镜像内的node_modules，避免依赖不一致。
• 之前的docker-entrypoint.sh not found错误，大概率是挂载本地目录时覆盖了镜像默认的entrypoint脚本。其实无需设置entrypoint: []，保留node镜像的默认entrypoint，它会自动处理node相关环境配置，稳定性更强。可以尝试移除entrypoint: []并配合方案1修正PATH，同时解决两个问题。

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