修改前端代码后Docker构建失败，出现EventEmitter内存泄漏警告

场景与配置 #

我正在开发React前端搭配.NET Core后端的Web应用，进行容器化部署时遇到了构建警告问题。以下是我的配置文件：

frontend.dockerfile #

FROM node:20.9.0-alpine
COPY frontend /frontend

# build frontend
WORKDIR /frontend
RUN npm ci
RUN npm run build

CMD ["npm", "start"]

backend.dockerfile #

#For more information, please see https://aka.ms/containercompat

FROM mcr.microsoft.com/dotnet/aspnet:7.0 AS base
WORKDIR /app
EXPOSE 80
EXPOSE 443
EXPOSE 5555

FROM mcr.microsoft.com/dotnet/sdk:7.0 AS build
WORKDIR /src

COPY ["./RedditAPI/RedditAPI.csproj", "/src"]
RUN dotnet restore "/src/RedditAPI.csproj"
COPY ./RedditAPI .
RUN dotnet build "/src/RedditAPI.csproj" -c Release -o /app/build

FROM build AS publish
RUN dotnet publish "/src/RedditAPI.csproj" -c Release -o /app/publish/p:UseAppHost=false

FROM base AS final
WORKDIR /app
ENV ASPNETCORE_URLS http://+:5555
COPY --from=publish /app/publish .
ENTRYPOINT ["dotnet", "RedditAPI.dll"]

docker-compose.yml #

version: "3.9"
services:
 frontend:
   build:
    context: .
    dockerfile: frontend.dockerfile
  image: frontend:latest
  container_name: frontend
  ports:
    - "3000:3000"
  environment:
    - CHOKIDAR_USEPOLLING=true
backend:
  container_name: backend
  build:
    context: .
    dockerfile: backend.dockerfile
  image: backend:latest
  environment:
    ASPNETCORE_ENVIRONMENT: Development
    ASPNETCORE_URLS: http://+:5555
  ports:
    - "5555:5555"

问题现象 #

首次构建完全正常，但修改前端代码（比如新增HTML标签）后，执行到RUN npm ci步骤时，出现多次MaxListenersExceededWarning警告，提示TLSSocket的close监听器数量超过限制。

原因说明 #

这个警告是Node.js默认限制导致的：npm ci拉取依赖时，并发发起的网络请求过多，每个请求会给TLSSocket添加close监听器，当数量超过默认的10个时，就会触发警告。修改代码后Docker缓存失效，需要重新执行npm ci，而首次构建时缓存命中，没有触发大量并发请求，所以没出现问题。

解决步骤 #

1. 优化Docker构建缓存（优先推荐） #

当前Dockerfile先复制整个frontend目录，修改代码会导致缓存失效，必须重新执行npm ci。调整复制顺序，先拷贝依赖配置文件，利用Docker缓存：

FROM node:20.9.0-alpine

WORKDIR /frontend
# 先复制package.json和package-lock.json，只有这两个文件变化时才会重新执行npm ci
COPY frontend/package*.json ./
RUN npm ci

# 再复制其他代码文件，代码修改只会触发后续的build步骤，不会重新安装依赖
COPY frontend .
RUN npm run build

CMD ["npm", "start"]

2. 提升Node.js监听器限制 #

如果缓存优化后仍有警告，可以临时提高EventEmitter的监听器上限：

# 在npm ci前设置环境变量
ENV NODE_OPTIONS="--max-event-listeners=100"
RUN npm ci

或者限制npm的并发请求数，减少监听器数量：

RUN npm config set maxsockets 5 && npm ci

3. 切换npm镜像源 #

如果是网络不稳定导致请求重试，换成国内镜像源（如淘宝镜像）可以减少重试次数，从而降低监听器数量：

RUN npm config set registry https://registry.npmmirror.com && npm ci

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