Express-session导致Heroku部署的应用抛出内部服务器错误如何解决？

架构老林

2026-10-5

故障根因与解决方案

导致该问题的核心原因是express-session默认配置不适用于Heroku这类PaaS生产环境，对应解决步骤如下：

替换默认内存存储
express-session默认使用MemoryStore存储session数据，仅适用于开发环境，存在内存泄漏风险，且Heroku的dyno无持久化内存、重启/休眠后数据会全部丢失，还会限制单进程内存占用，极易触发崩溃。需要替换为生产级持久化存储，常用方案有connect-redis（基于Redis）、connect-mongo（基于MongoDB），可直接对接Heroku上的Redis/MongoDB附加服务。
配置环境变量
不要在代码中硬编码secret、数据库连接串等敏感配置，本地开发时可通过.env文件配置，部署到Heroku时需要进入应用后台的「Settings」-「Config Vars」板块，添加对应的变量，比如SESSION_SECRET（session加密密钥）、MONGODB_URI/REDIS_URL（存储服务连接串）。
适配Heroku反向代理
Heroku的请求会经过一层反向代理转发到应用进程，需要在session配置中添加proxy: true，保证应用可以正确识别HTTPS请求，避免secure属性的cookie无法正常写入触发报错。

配置示例

安装依赖

npm install connect-mongo express-session

服务端session配置代码

const session = require('express-session');
const MongoStore = require('connect-mongo');

app.use(session({
  secret: process.env.SESSION_SECRET,
  resave: false,
  saveUninitialized: false,
  proxy: true,
  store: MongoStore.create({
    mongoUrl: process.env.MONGODB_URI
  }),
  cookie: {
    secure: process.env.NODE_ENV === 'production',
    maxAge: 24 * 60 * 60 * 1000
  }
}));