docker-compose启动时NestJS后端AppGateway初始化失败如何解决？

该问题是NestJS官方依赖版本不兼容导致的，具体触发逻辑如下：

• 你的依赖配置中，@nestjs/common、@nestjs/core的版本范围是^7.0.0，而@nestjs/websockets、@nestjs/platform-socket.io的版本固定为7.3.2，两个类别的依赖版本没有对齐。
• 本地运行正常是因为你本地的node_modules已经锁定了兼容的依赖版本；Docker构建时默认会拉取^7.0.0范围内最新的7.x版本，更高版本的@nestjs/common调整了addLeadingSlash工具函数的导出规则，低版本的@nestjs/websockets无法正常调用该函数，就抛出了对应的类型错误。

按优先级可以选择以下任意一种方案：

方案1：统一所有NestJS官方依赖版本（推荐） #

将所有@nestjs/开头的依赖版本统一为NestJS 7的最终稳定版，移除版本号前的^避免自动升级小版本，修改后的依赖配置示例如下：

"@nestjs/common": "7.6.18",
"@nestjs/core": "7.6.18",
"@nestjs/jwt": "7.2.0",
"@nestjs/passport": "7.1.6",
"@nestjs/platform-express": "7.6.18",
"@nestjs/platform-socket.io": "7.6.18",
"@nestjs/serve-static": "2.2.2",
"@nestjs/typeorm": "7.1.5",
"@nestjs/websockets": "7.6.18",
"@types/socket.io": "^2.1.8",

修改完成后重新安装依赖、构建镜像即可。

方案2：锁定Docker依赖安装逻辑 #

保证Docker构建时严格使用本地的依赖锁文件，避免自动拉取最新版本，修改Dockerfile的安装逻辑示例：

WORKDIR /app
# 同时复制依赖锁文件到镜像内
COPY package*.json ./
# 用npm ci代替npm install，严格按照锁文件版本安装
RUN npm ci
# 后续复制代码、构建的逻辑保持不变
COPY . .
RUN npm run build

方案3：临时绕过（不推荐长期使用） #

在你的WebSocket网关@WebSocketGateway()装饰器中，给namespace参数手动添加前导斜杠，绕过addLeadingSlash方法的调用，比如：
原来的写法：@WebSocketGateway('my-namespace')
修改为：@WebSocketGateway('/my-namespace')

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