Docker部署Express.js失败：模块导入与依赖丢失问题排查

核心问题1：ES模块语法错误 #

你的server.js使用了ES模块的import语法，但默认情况下Node.js将.js文件视为CommonJS模块，因此触发语法报错。同时Docker容器中直接用node server.js启动服务，没有用到package.json里配置的babel-node转译ES语法，进一步导致语法不兼容。

解决方案（二选一）： #

方案A：启用ES模块支持

在package.json中添加"type": "module"配置，告诉Node.js将.js文件视为ES模块：

{
  "name": "socketapp",
  "version": "1.0.0",
  "type": "module", // 新增该行
  "description": "",
  // 其余配置保持不变
}

同时将server.js中的CommonJS语法统一改为ES模块形式：

import express from "express";
import { createServer } from "http";
import { Server } from "socket.io";

const app = express();
const server = createServer(app);
const io = new Server(server, { allowEIO3: true });
// 其余代码不变

方案B：统一使用CommonJS语法

将server.js中的import语句替换为require，保持语法一致性：

const express = require("express");
const server = require("http").createServer(app);
const io = require("socket.io")(server, { allowEIO3: true });
// 其余代码不变

核心问题2：无法找到express模块 + 本地看不到容器的node_modules #

这是Docker挂载覆盖容器内依赖目录导致的：
你在docker-compose.yaml中把本地项目根目录挂载到了容器的/var/www，容器内npm install安装的依赖存放在/var/www/app/node_modules，但如果本地项目目录没有node_modules，挂载后容器内的这个目录会被本地空目录覆盖，导致Node.js找不到模块；同时本地看不到容器的node_modules，也是因为挂载优先级高于容器内文件，本地没有对应的目录就无法显示。

解决方案： #

在docker-compose.yaml的volumes中添加匿名卷，单独保留容器内的node_modules目录，避免被本地挂载覆盖：

version: '3.8'
services:
  node:
      build:
          context: ../
          dockerfile: .docker/node/Dockerfile
      container_name: node-app
      restart: always
      ports:
          - '3000:3000'
      volumes:
          - ../:/var/www
          - /var/www/app/node_modules # 新增匿名卷，保护容器内的依赖目录
      environment:
          PORT: 3000

如果需要本地也看到依赖包，可在本地执行npm install，确保本地与容器内的node_modules目录内容一致。

额外优化：使用package.json的启动脚本 #

你的package.json配置了babel-node启动服务，但Docker的CMD直接用node server.js未利用该配置。可修改Dockerfile的CMD，使用npm启动命令，自动兼容ES语法：

FROM node:18.16.1

RUN apt-get update && apt-get install -y \
  nano

WORKDIR /var/www/app

COPY ./app/package*.json ./

RUN npm install

COPY ./app ./

CMD [ "npm", "start" ] # 替换原有的node server.js

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