Firebase部署环境无法接收WebSocket连接问题求助

核心问题分析 #

本地能正常运行是因为可以直接绑定端口，但Firebase的托管环境（包括Hosting和Functions）不支持直接监听固定端口的Node.js服务——它是无服务器架构，所有请求都通过Firebase的边缘网络转发，所以你原来new WebSocket.Server({ port: 8080 })的写法在Firebase环境下完全无效。之前尝试Firebase Functions无效，是因为没走正确的HTTP触发挂载方式。

正确解决方案 #

1. 重构WebSocket服务为Firebase HTTP函数

把WebSocket服务挂载到HTTP服务器上，通过Firebase Functions的HTTP入口暴露。修改你的服务端代码如下：

const functions = require('firebase-functions');
const WebSocket = require('ws');
const http = require('http');

// 创建HTTP服务器，用于挂载WebSocket服务
const server = http.createServer();
const wss = new WebSocket.Server({ server });

// 保留你原来的WebSocket业务逻辑
wss.on("connection", (ws) => {
    ws.on("error", console.error);

    getCount().then(count => {
        ws.send(count);
    }).catch(err => {
        console.log(err);
    })

    ws.on("message", (data) => {
        console.log("received " + data);
        if (data >= 120) {
            console.log("not using " + data);
            return;
        }
        
        getCount().then(count => {
            let total = count + parseInt(data);
            ws.send(total);
            writeCount(total);
        }).catch(err => {
            console.log(err);
        })
    });
});

// 导出HTTP触发的Firebase函数
exports.wsServer = functions.https.onRequest((req, res) => {
    server.emit('request', req, res);
});

2. 修正客户端连接地址

客户端不能再用SERVERIP:8080，必须使用Firebase Functions的公网URL。替换客户端代码中的wsAddress：

// 替换成你的Functions实际地址，格式为：https://<区域>-<项目ID>.cloudfunctions.net/wsServer
const wsAddress = `${window.location.protocol.includes('https') ? 'wss' : 'ws'}://<your-region>-<your-project-id>.cloudfunctions.net/wsServer`;

如果用Firebase Hosting托管前端，可以在firebase.json中配置转发规则，让前端用更友好的域名访问：

{
  "hosting": {
    "rewrites": [
      {
        "source": "/ws",
        "function": "wsServer"
      }
    ]
  }
}

此时客户端地址可以改为：

const wsAddress = `${window.location.protocol.includes('https') ? 'wss' : 'ws'}://${window.location.host}/ws`;

3. 关键注意事项

• 无服务器超时限制：Firebase Functions默认超时60秒，最长可配置到9分钟。如果需要持续长时间连接，必须添加心跳机制（比如每隔30秒客户端和服务器互发ping/pong），避免连接被自动断开。
• 数据存储适配：如果你的getCount()和writeCount()是读写本地文件，在Firebase Functions中会失效——因为无服务器环境是临时容器，本地文件不持久。必须换成Firestore、Realtime Database或Cloud Storage来存储数据。
• 部署命令：部署时执行firebase deploy --only functions（如果同时部署Hosting则加--only functions,hosting）。

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