使用Docker构建Nest.js+TypeScript项目时遇import语法错误

问题根源 #

错误本质是Node.js直接尝试执行未编译的TypeScript(.ts)文件，而TypeScript的import语法无法被CommonJS模块系统直接解析。

具体解决方案 #

1. 完善package.json的脚本配置 #

确保你的package.json包含正确的构建和启动脚本：

{
  "scripts": {
    "build": "nest build",
    "start": "node dist/main",
    "start:prod": "node dist/main"
  }
}

• build：通过Nest CLI将TypeScript编译为JavaScript，输出到dist目录（对应tsconfig里的outDir）
• start：运行编译后的主入口文件dist/main.js

2. 修改Dockerfile，添加编译步骤 #

你的Dockerfile缺少TypeScript编译环节，需要在启动前执行npm run build：

FROM node:18

# Install wait-for-it
ADD https://raw.githubusercontent.com/vishnubob/wait-for-it/master/wait-for-it.sh /usr/bin/wait-for-it
RUN chmod +x /usr/bin/wait-for-it

WORKDIR /app

# Copy and install dependencies
COPY package.json ./
RUN npm install

# Copy the rest of the application code
COPY . .

# 新增编译步骤：将TypeScript编译为JavaScript
RUN npm run build

# Start the application, waiting for the database to be ready
CMD ["wait-for-it", "db:5432", "--", "npm", "run", "start"]

3. 修正TypeORM的实体路径配置 #

由于错误发生在加载实体文件时，需要确保TypeORM指向编译后的.js实体文件：

• 如果使用app.module.ts中的TypeOrmModule配置：

import { Module } from '@nestjs/common';
import { TypeOrmModule } from '@nestjs/typeorm';
import { join } from 'path';

@Module({
  imports: [
    TypeOrmModule.forRoot({
      type: 'postgres', // 你的数据库类型
      host: 'db',
      port: 5432,
      username: 'your-username',
      password: 'your-password',
      database: 'your-db',
      // 同时支持ts（开发）和js（生产）实体文件
      entities: [join(__dirname, '**', '*.entity.{ts,js}')],
      synchronize: true, // 生产环境建议关闭
    }),
  ],
})
export class AppModule {}

• 如果使用TypeORM的dataSource.ts配置：

import { DataSource } from 'typeorm';
import { join } from 'path';

export const AppDataSource = new DataSource({
  type: 'postgres',
  host: 'db',
  port: 5432,
  username: 'your-username',
  password: 'your-password',
  database: 'your-db',
  entities: [join(__dirname, '**', '*.entity.{ts,js}')],
  synchronize: true,
});

4. 添加.dockerignore文件（可选但推荐） #

创建.dockerignore文件，避免本地文件干扰Docker构建：

node_modules
dist
.git
.env

验证步骤 #

1. 重新构建镜像：docker-compose build
2. 启动容器：docker-compose up

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