Docker化React应用出现Cannot find module 'react'错误求助

1. 清理本地Docker缓存与依赖卷 #

• 停止并移除容器（连带关联卷，避免旧依赖残留）：docker-compose down -v
• 清理Docker冗余缓存：docker system prune -a（注意：该命令会删除未使用的镜像、容器等，确认无重要内容再执行）
• 重新构建并启动服务：docker-compose up --build

2. 检查.dockerignore配置 #

确保配置既排除本地node_modules避免污染容器依赖，又不遗漏依赖配置文件：

node_modules
npm-debug.log
.git
.gitignore

3. 修正Dockerfile的依赖安装流程 #

必须先复制依赖配置文件，完成安装后再复制项目代码，避免缓存失效或依赖被覆盖，示例正确写法：

FROM node:18-alpine

WORKDIR /app

# 先复制依赖配置文件，利用Docker缓存
COPY package*.json ./

RUN npm install

# 最后复制项目代码
COPY . .

CMD ["npm", "start"]

4. 统一依赖锁定文件 #

确保项目提交了package-lock.json（npm）或yarn.lock（yarn），让同事克隆后安装的依赖版本完全一致，避免版本差异导致模块缺失：

• 使用npm：执行npm install后提交生成的package-lock.json
• 使用yarn：执行yarn install后提交yarn.lock

5. 排查docker-compose.yml的卷挂载坑 #

如果配置了本地目录挂载，必须排除node_modules路径，避免本地空目录或旧依赖覆盖容器内安装的依赖：

version: '3.8'
services:
  react-app:
    build: .
    ports:
      - "3000:3000"
    volumes:
      - .:/app
      - /app/node_modules  # 匿名卷保留容器内的依赖，不受本地挂载影响

6. 强制重新构建镜像 #

强制跳过Docker构建缓存，确保依赖完全重新安装：
docker-compose build --no-cache
执行完成后启动服务：docker-compose up

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