Socket.io聊天应用‘Error: server error’问题排查求助

核心问题定位 #

你的代码里**app.use(cors)**这一行存在错误：cors是需要调用的函数，必须写成app.use(cors())，否则Express无法正确加载CORS中间件，导致Socket.IO的握手阶段失败，触发客户端的server error提示。

修复后的server.js代码 #

const path = require("path")
const express = require("express")
const http = require("http")
require("dotenv").config()
const Server = require("socket.io")
const cors = require("cors")


const app = express()
const server = http.createServer(app);
// 给Socket.IO单独配置CORS（更稳妥的跨域控制）
const io = new Server(server, {
  cors: {
    origin: "*", // 开发环境可临时用*，生产环境替换为实际前端域名
    methods: ["GET", "POST"]
  }
})
const port = process.env.PORT
const public_directory = path.join(__dirname, "../public")

app.use(express.static(public_directory))
app.use(cors()) // 修复此处：调用cors函数生成中间件
io.on("connection", (socket)=>{
    console.log("user here : " , socket.id)
  
    socket.on('disconnect', () => console.log('disconnected'));
})

server.listen(port, ()=>{
    console.log(`Listening on port : ${port} `)
})

额外说明 #

• 你看到服务器打印socket.id，仅代表TCP连接已建立，但Socket.IO的握手流程因CORS配置错误未完成，所以客户端仍会触发连接错误。
• 给Socket.IO实例单独配置CORS是更推荐的方式，能精准控制Socket连接的跨域规则，避免与Express的CORS配置冲突。
• 生产环境禁止使用origin: "*"，需替换为你的前端实际域名（如http://localhost:3000），保障安全性。

验证修复 #

重启服务器后，客户端控制台应打印Connected to the server，不再出现server error提示，此时即可正常添加消息发送与监听的逻辑。

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