{"id":"88c66a6d8745ff13","repo":"nestjs/nest","slug":"invalid-port-port-in-gateway-type","errorCode":null,"errorMessage":"Invalid port (${port}) in gateway ${type}","messagePattern":"Invalid port \\((.+?)\\) in gateway (.+?)","errorType":"exception","errorClass":"InvalidSocketPortException","httpStatus":null,"severity":"error","filePath":"packages/websockets/web-sockets-controller.ts","lineNumber":55,"sourceCode":"  constructor(\n    private readonly socketServerProvider: SocketServerProvider,\n    private readonly config: ApplicationConfig,\n    private readonly contextCreator: WsContextCreator,\n    private readonly graphInspector: GraphInspector,\n    private readonly appOptions: NestApplicationContextOptions = {},\n  ) {}\n\n  public connectGatewayToServer(\n    instance: NestGateway,\n    metatype: Type<unknown> | Function,\n    moduleKey: string,\n    instanceWrapperId: string,\n  ) {\n    const options = Reflect.getMetadata(GATEWAY_OPTIONS, metatype) || {};\n    const port = Reflect.getMetadata(PORT_METADATA, metatype) || 0;\n\n    if (!Number.isInteger(port)) {\n      throw new InvalidSocketPortException(port, metatype);\n    }\n    this.subscribeToServerEvents(\n      instance,\n      options,\n      port,\n      moduleKey,\n      instanceWrapperId,\n    );\n  }\n\n  public subscribeToServerEvents<T extends GatewayMetadata>(\n    instance: NestGateway,\n    options: T,\n    port: number,\n    moduleKey: string,\n    instanceWrapperId: string,\n  ) {\n    const nativeMessageHandlers = this.metadataExplorer.explore(instance);","sourceCodeStart":37,"sourceCodeEnd":73,"githubUrl":"https://github.com/nestjs/nest/blob/6ec0e2783d15290732447f304d8549b591b9749e/packages/websockets/web-sockets-controller.ts#L37-L73","documentation":"Error \"Invalid port (${port}) in gateway ${type}\" thrown in nestjs/nest.","triggerScenarios":"Thrown at packages/websockets/web-sockets-controller.ts:55 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Provide a valid port number (0-65535) in @WebSocketGateway(port) or in the gateway options.","Remove the port option to use the default HTTP server port instead of an invalid value.","Ensure the port value is a number, not a string or undefined variable."],"exampleFix":"@WebSocketGateway(3001, { namespace: 'events' })\nexport class EventsGateway {}","handlingStrategy":null,"validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"analyzedSha":"6ec0e2783d15290732447f304d8549b591b9749e","analyzedAt":"2026-08-03T17:42:23.673Z","schemaVersion":2}