部署至Heroku的Node.js电商应用报错：/cart路由Cookie创建失败

我之前在部署Node.js电商应用到Heroku时也碰到过类似的Cookie相关问题，结合你给出的日志和症状，帮你拆解下问题根源和解决步骤：

• 生产环境Cookie的安全属性不兼容：Heroku默认强制使用HTTPS（即使你输入HTTP也会自动重定向），如果你的createCart函数里设置Cookie时没有开启Secure属性，或者没有正确识别Heroku的代理协议，浏览器会拒绝保存Cookie，导致购物车令牌无法存储。
• 未捕获的错误事件：日志里的Error: Unhandled "error" event说明你的cart.js中某个异步操作（比如Cookie写入、数据库交互）触发了错误，但没有添加错误捕获逻辑，直接导致应用崩溃。
• Cookie的Domain/Path配置错误：如果硬编码了Cookie的Domain为localhost，或者Path设置的范围不包含/cart路由，浏览器会拒绝在Heroku的生产域名下写入Cookie。

1. 适配Heroku HTTPS环境的Cookie配置 #

如果你用的是Express框架，首先要让应用信任Heroku的反向代理，这样才能正确识别请求的真实协议（HTTPS），然后根据环境动态设置Cookie的安全属性：

// 在应用入口文件（比如app.js）添加代理信任配置
app.set('trust proxy', 1);

// 定义Cookie的通用配置
const cartCookieOptions = {
  httpOnly: true, // 防止前端JS读取，提升安全性
  secure: process.env.NODE_ENV === 'production', // 生产环境强制开启Secure
  sameSite: process.env.NODE_ENV === 'production' ? 'none' : 'lax', // 跨域场景需设为none，必须配合Secure
  maxAge: 7 * 24 * 60 * 60 * 1000, // 购物车令牌有效期设为7天
  path: '/' // 确保全应用路由都能访问该Cookie
};

// 在createCart函数中使用该配置写入Cookie
module.exports = function createCart(req, res) {
  const cartToken = generateUniqueToken(); // 替换成你的令牌生成逻辑
  res.cookie('cartToken', cartToken, cartCookieOptions);
  
  // 后续的购物车创建逻辑...
};

注意：当SameSite设为none时，Secure必须为true，否则现代浏览器会直接拒绝保存Cookie。

2. 捕获并处理所有错误事件 #

日志里的未处理错误是导致应用崩溃的直接原因，必须给所有异步操作添加错误捕获：

// 用async/await的方式重构createCart，方便捕获错误
module.exports = async function createCart(req, res) {
  try {
    // 生成购物车令牌&写入数据库的逻辑
    const cartToken = generateUniqueToken();
    await CartModel.create({ token: cartToken }); // 假设你用ORM操作数据库
    
    // 写入Cookie
    res.cookie('cartToken', cartToken, cartCookieOptions);
    res.status(200).json({ success: true, cartToken });
  } catch (err) {
    // 打印详细错误日志到Heroku
    console.error('Create cart failed:', err);
    // 返回友好的错误响应
    res.status(500).json({ error: 'Failed to create shopping cart' });
  }
};

另外，给Express添加全局错误处理中间件，避免未捕获的错误导致整个应用挂掉：

// 放在所有路由之后
app.use((err, req, res, next) => {
  console.error('Unhandled error:', err.stack);
  res.status(500).send('Server encountered an unexpected error');
});

3. 检查Heroku环境变量配置 #

确保Heroku的NODE_ENV已设置为production，这样你的Cookie配置才会生效：

# 执行Heroku命令设置环境变量
heroku config:set NODE_ENV=production

同时通过heroku logs --tail实时查看日志，获取错误的完整堆栈信息，能帮你精准定位cart.js中出错的具体行。

4. 修正Cookie的Domain配置 #

不要硬编码Domain为开发环境的localhost，生产环境下可以留空（浏览器会自动使用当前域名），或者针对你的Heroku域名设置：

const cartCookieOptions = {
  // ...其他配置
  domain: process.env.NODE_ENV === 'production' ? '.your-app-name.herokuapp.com' : undefined
};

如果使用自定义域名，替换成你的自定义域名即可，注意前面的.可以让子域名也能访问该Cookie。

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