Docker构建Node.js应用时出现Joi模块找不到错误求助

问题描述 #

本地可正常运行与构建的TypeScript Node.js应用，执行docker build时出现错误：
Cannot find module 'Joi' or its corresponding type declarations.

排查与解决方案 #

1. 检查代码中Joi的导入大小写 #

你的package.json中依赖的是小写的joi，但Node.js模块解析区分大小写。如果代码里写成了import Joi from 'Joi'（大写开头），就会导致容器内找不到模块，需修正为：

import Joi from 'joi';

2. 完善Docker构建的依赖安装步骤 #

原Dockerfile仅复制了package.json，未同步package-lock.json，这可能导致容器内npm install安装的依赖版本与本地不一致，进而引发模块问题。修改Dockerfile，同时复制两个锁文件：

FROM node:20-alpine as dependencies
WORKDIR /app

# 同时复制package.json和package-lock.json以保证依赖版本一致
COPY package.json package-lock.json ./

RUN npm install

COPY . .

RUN npm run build

EXPOSE 5000
CMD ["npm", "start"]

3. 验证TypeScript配置（可选） #

若上述步骤无效，检查tsconfig.json的模块解析配置，确保compilerOptions包含以下关键项：

{
  "compilerOptions": {
    "module": "commonjs",
    "resolveJsonModule": true,
    "esModuleInterop": true
  }
}

附用户提供的原始文件内容 #

Dockerfile #

FROM node:20-alpine as dependencies
# Set the working directory to /app
WORKDIR /app

# Copy the package.json and package-lock.json files to /app
COPY package.json ./

# Install dependencies
RUN npm install

# Copy the rest of the application code to /app
COPY . .

RUN npm run build

# Expose port 5000
EXPOSE 5000

# Start the server
CMD ["npm", "start"]

.dockerignore #

.git
node_modules

package.json #

{
  "name": "Platform_user",
  "version": "1.0.0",
  "main": "index.js",
  "repository": "https://github.com/devarshiroy93/Platform_user.git",
  "author": "devarshiroy93 <devarshiroy93@gmail.com>",
  "license": "MIT",
  "scripts": {
    "start": "node dist/index",
    "build": "tsc -p .",
    "dev": "tsc-watch --onSuccess \"node dist/index.js\" "
  },
  "devDependencies": {
    "@types/bcrypt": "^5.0.2",
    "@types/cors": "^2.8.17",
    "@types/express": "^4.17.21",
    "@types/jsonwebtoken": "^9.0.5",
    "@types/node": "^20.11.5",
    "prisma": "^5.8.1",
    "tsc-watch": "^6.0.4",
    "typescript": "^5.3.3"
  },
  "prisma": {
    "schema": "src/infrastructure/db/prisma/schema.prisma"
  },
  "dependencies": {
    "@prisma/client": "^5.8.1",
    "bcrypt": "^5.1.1",
    "cors": "^2.8.5",
    "dotenv": "^16.3.2",
    "express": "^4.18.2",
    "joi": "^17.12.2",
    "jsonwebtoken": "^9.0.2"
  }
}

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