NestJS+GraphQL(Apollo)服务器仅localhost可访问，IP无法连接求助

问题现象 #

使用http://localhost:3001/graphql可正常访问GraphQL端点，但切换为本机IP（如http://192.168.1.100:3001/graphql）时无法建立连接，已在main.ts设置监听0.0.0.0并开启CORS，但未生效。

核心原因 #

NestJS主应用监听0.0.0.0不代表Apollo GraphQL服务器也会绑定该地址，默认情况下Apollo Server可能仅监听localhost，需要单独配置。

解决方案 #

1. 配置Apollo Server监听地址及CORS #

在AppModule中配置GraphQL模块时，显式指定Apollo Server的host为0.0.0.0，并同步配置CORS规则：

import { Module } from '@nestjs/common';
import { GraphQLModule } from '@nestjs/graphql';
import { ApolloDriver, ApolloDriverConfig } from '@nestjs/apollo';
import { join } from 'path';

@Module({
  imports: [
    GraphQLModule.forRoot<ApolloDriverConfig>({
      driver: ApolloDriver,
      autoSchemaFile: join(process.cwd(), 'src/schema.gql'),
      playground: true, // 开启GraphQL playground
      // 配置Apollo Server参数
      server: {
        host: '0.0.0.0', // 绑定所有网卡地址
        cors: {
          origin: '*', // 允许所有来源（生产环境建议指定具体域名）
          credentials: true,
          methods: ['GET', 'POST'],
        },
      },
    }),
  ],
})
export class AppModule {}

2. 验证服务器启动日志 #

启动服务后，检查控制台输出的地址是否为http://0.0.0.0:3001，而非仅http://localhost:3001。如果日志显示绑定了0.0.0.0，说明主应用和Apollo Server的监听配置已生效。

3. 排查网络及防火墙限制 #

• 确认使用的是本机局域网IP（而非127.0.0.1），可通过ipconfig（Windows）或ifconfig（Linux/macOS）查看。
• 检查本机防火墙是否开放了3001端口，临时关闭防火墙测试是否能访问。
• 若在虚拟机或容器中运行，需确保端口已正确映射到宿主机。

4. 验证CORS配置有效性 #

如果浏览器控制台出现跨域相关错误，可调整cors配置中的origin字段，指定具体的IP或域名（如http://192.168.1.100:3001），而非通配符*（部分浏览器对通配符+credentials的组合有限制）。

补充说明 #

NestJS的app.enableCors()仅作用于主Express/Fastify应用，Apollo Server作为独立的HTTP服务，需要单独配置CORS和监听地址，两者的配置是分离的，这是导致问题的常见原因。

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