Express+WebSocket搭建NodeJS服务对接Flutter，Heroku部署端口地址配置问题

算力阿峰

2026-10-1

核心问题原因

Heroku 平台仅对外暴露一个系统自动分配的端口，即代码中通过process.env.PORT获取的端口，不支持自定义额外端口对外提供服务。你当前代码中WebSocket服务单独监听6060端口，该端口无法被外网访问，因此部署后连接失败。

服务端(index.js)修改方案

将WebSocket服务挂载到已有的Express HTTP服务上，共用同一个端口，无需额外监听新端口：

先将Express服务的启动返回值赋值给server变量
WebSocket服务初始化时直接传入server参数，无需指定port
修改后的完整代码如下：

const WebSocket = require('ws');
const express = require('express');
const app = express();
const PORT = process.env.PORT || 3000;

app.get('/', (req, res) => {
    res.sendFile(__dirname + '/lib/index.html');
});

// 存储server实例
const server = app.listen(PORT, () => {
    console.log(`listening at: ${PORT}`)
});

var webSockets = {}

// 挂载到现有server，无需单独指定端口
const wss = new WebSocket.Server({ server })

wss.on('connection', function (ws, req)  {
    var userID = req.url.substr(1)
    console.log('User connected:', userID)
    webSockets[userID] = ws
    ws.on('message', message => {
        console.log(message)
        ws.send("success");
    })
})

Flutter端修改方案

连接地址做两处调整即可：

协议从ws替换为wss，匹配Heroku默认的SSL配置
去掉端口号，Heroku会自动将WSS请求转发到你的服务端口
修改后的连接代码：

import 'package:web_socket_channel/io.dart';

channel = IOWebSocketChannel.connect('wss://example.herokuapp.com/user1');
String message = "{'cmd':'This message should be sended to Heroku'}";

channel.sink.add(message);

channel.stream.listen((message) async {
   print(message);
});

补充注意事项