Docker容器无法找到已安装Node依赖的问题求助

问题 #

启动Docker容器时出现依赖找不到的问题，具体错误提示：

error TS2307: Cannot find module '<dependency>' or its corresponding type declarations.

本地运行完全正常，仅Docker环境下触发该问题。已尝试删除构建文件及node_modules文件夹，进入容器终端执行yarn list能查到目标依赖，执行yarn add <dependency>也提示安装成功，但错误依旧存在。

相关配置 #

Dockerfile

FROM node:16-alpine AS dev

WORKDIR /app
COPY yarn.lock ./
COPY package.json ./
COPY . .
WORKDIR /app/api
RUN yarn install
RUN yarn build

EXPOSE 8000

CMD ["yarn", "dev"]

docker-compose.yml

services:
  api:
    profiles: ['api', 'web']
    container_name: slots-api
    stdin_open: true
    build:
      context: ./
      dockerfile: api/Dockerfile
      target: dev
    environment:
      NODE_ENV: development
    ports:
      - 8000:8000
      - 9229:9229 # for debugging
    volumes:
      - ./api:/app/api
      - /app/node_modules/ # do not mount node_modules
      - /app/api/node_modules/ # do not mount node_modules
    depends_on:
      - database
    command: yarn dev

解决方案 #

1. 补全TypeScript类型依赖 #

TS2307错误大概率和类型声明缺失有关，即使依赖本体已安装，对应的@types/<dependency>可能未配置。在容器内执行：

yarn add -D @types/<dependency>

如果是无官方类型的第三方库，可临时在tsconfig.json中设置"noImplicitAny": false规避，或手动创建类型声明文件。

2. 调整Dockerfile的依赖安装逻辑 #

当前Dockerfile先把所有文件复制到根目录再进入子目录安装依赖，容易导致路径混乱。修改为直接在目标工作目录操作：

FROM node:16-alpine AS dev

WORKDIR /app/api
COPY api/yarn.lock ./
COPY api/package.json ./
COPY api/ .
RUN yarn install
RUN yarn build

EXPOSE 8000

CMD ["yarn", "dev"]

确保依赖安装路径和后续挂载的卷目录完全匹配。

3. 清理旧容器与匿名卷 #

docker-compose的卷挂载可能保留了旧的依赖缓存，导致新安装的依赖无法生效。执行以下命令彻底清理：

docker-compose down -v
docker-compose build --no-cache api
docker-compose up api

确保容器内的node_modules完全由构建阶段的yarn install生成，不受本地目录污染。

4. 校验TypeScript模块解析配置 #

检查tsconfig.json中的baseUrl和paths设置，确保模块解析路径和容器内的文件结构一致。比如设置baseUrl: "./src"时，要保证容器内/app/api/src的目录结构和本地完全同步。

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