Laravel项目中Node Docker容器无法执行npm run dev命令

方案一：以node用户运行npm容器（推荐） #

修改docker-compose.yml中的npm服务，添加user: node配置，让容器以官方Node镜像自带的非root用户运行：

npm:
    image: node:current-alpine
    volumes:
        - ./:/var/www/html
    entrypoint: [ "npm" ]
    working_dir: /var/www/html
    user: node

原理 #

• 官方node:alpine镜像默认包含node用户（UID/GID通常为1000），和你PHP容器中laravel用户的UID/GID一致，避免项目目录的权限冲突。
• 切换到node用户后，npm会使用/home/node/.npm作为缓存目录，不再访问root用户的/root/.npm，彻底避开之前的权限问题。

修改配置后，直接重新运行命令即可：

docker-compose run --rm npm run dev

方案二：自定义npm缓存目录到项目内 #

如果不想切换用户，可以将npm缓存目录指定到挂载的项目目录中，确保权限和项目目录一致：

修改docker-compose.yml的npm服务，添加环境变量指定缓存路径：

npm:
    image: node:current-alpine
    volumes:
        - ./:/var/www/html
    entrypoint: [ "npm" ]
    working_dir: /var/www/html
    environment:
        - NPM_CONFIG_CACHE=/var/www/html/.npm-cache

后续操作 #

1. 手动创建缓存目录并设置匹配项目的权限：

mkdir .npm-cache
chown -R laravel:laravel .npm-cache

2. 重新运行npm命令：

docker-compose run --rm npm run dev

为什么之前的操作无效？ #

你之前尝试清理缓存或修改/root/.npm的权限，但问题根源是npm以root用户运行时，/root目录的权限限制会持续影响后续操作，且切换到非root用户后根本不会再使用这个目录，所以之前的操作无法解决问题。

内容的提问来源于stack exchange，提问作者A. Vreeswijk