WSL2后端Docker环境中npm命令无法识别的问题求助

核心问题定位 #

两个错误的根源大概率集中在shell脚本格式/执行逻辑、Docker工作目录配置这两个点上，结合你提到“其他未使用shell脚本的项目正常”，优先排查run.sh脚本和容器工作环境的问题。

分步解决方案 #

1. 修复run.sh脚本的基础问题

• 添加正确的Shebang头：脚本开头必须指定解析器，避免容器用sh执行导致语法兼容问题

  #!/bin/bash
  

• 修正命令格式：检查是否存在多余引号（比如误写为npm "install"），正确写法应为：

  # 先切换到项目目录
  cd /app
  npm install
  npm run dev
  

• 统一换行符格式：WSL2下如果脚本用Windows格式（CRLF）保存，容器内解析会把命令变成npm install\r，导致系统识别为未知命令。用编辑器将脚本转为Unix LF格式（VS Code右下角可切换）。
• 添加执行权限：在WSL2终端给脚本加可执行权限：

  chmod +x run.sh
  

2. 确认Docker Compose的工作目录配置

确保容器内的项目目录与本地挂载目录对应，保证package.json能被正确读取：

# docker-compose.yml 关键配置示例
services:
  frontend:
    image: node:lts-bullseye
    working_dir: /app  # 指定容器内的工作目录
    volumes:
      - ./:/app  # 将本地项目根目录挂载到容器的/app目录
    command: ./run.sh  # 执行脚本

3. 排查镜像与命令可用性

先单独验证镜像的npm是否正常，排除镜像本身问题：

docker run --rm -it node:lts-bullseye npm --version

如果能正常输出npm版本，说明镜像没问题，问题仍出在脚本或挂载配置上。

4. 临时绕过脚本验证逻辑

如果脚本问题难以定位，可以直接在docker-compose.yml中替换command字段，跳过脚本执行，验证核心逻辑：

command: sh -c "cd /app && npm install && npm run dev"

如果这个命令能正常运行，说明run.sh脚本存在语法或格式错误，回到第一步重新排查。

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