使用环境变量配置express-session secret时Socket.IO报错求助

核心原因分析 #

虽然你确认dotenv已导入环境变量，但大概率是环境变量加载时机晚于session中间件初始化，或是类型断言掩盖了变量实际未赋值的情况，导致express-session拿到的secret值无效（比如undefined），从而触发报错。明文字符串能正常工作，说明session配置本身逻辑无问题。

分步解决方案 #

1. 确保dotenv在所有模块导入前加载 #

ES模块的import语句会被引擎优先处理，如果session中间件模块在dotenv加载前就被导入，此时process.env.COOKIES_SECRET还未被赋值，最终导致secret为undefined。

修改index.ts，将dotenv加载放在最顶部：

// index.ts 最顶部
import dotenv from 'dotenv';
// 可指定.env文件路径，默认读取项目根目录
dotenv.config({ path: './.env' });

// 再导入其他模块
import session from './middlewares/session';
// ...其他代码

2. 移除类型断言，添加变量有效性校验 #

<string>类型断言会强制将process.env.COOKIES_SECRET转为string类型，但如果变量实际是undefined，会被转为字符串"undefined"，而express-session会判定这个值不符合secret要求。

修改session中间件代码，添加校验：

// session.ts
import session from "express-session";
import generateRandomString from "../functions/generate-random-string";

// 先校验环境变量是否存在
const cookieSecret = process.env.COOKIES_SECRET;
if (!cookieSecret) {
  throw new Error("环境变量COOKIES_SECRET未设置，请检查.env文件");
}

export default session({
    name: "session_token",
    genid: () => generateRandomString(300),
    secret: cookieSecret, // 直接使用已校验的变量
    cookie: {
        // domain: process.env.HOST as string, // 若启用需同步校验
        httpOnly: true,
        maxAge: 6 * 30 * 24 * 60 * 60 * 1000,
        sameSite: "lax",
        secure: true,
    },
    resave: false,
    saveUninitialized: false
})

3. 优化Socket.IO的middleware wrap函数 #

当前wrap函数传递的第二个参数是空对象，虽然明文secret时能运行，但express-session的中间件可能依赖response对象的某些属性。建议替换为socket自带的response对象：

// initSocketServer.ts
const wrap = (middleware: any) => (socket: any, next: any) => 
  middleware(socket.request, socket.request.res || {}, next);

验证步骤 #

1. 重启服务器，若启动时抛出COOKIES_SECRET未设置错误，说明.env文件配置有误或路径不对。
2. 若无启动错误，尝试客户端连接，确认connect_error不再触发。

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