Express NodeJS 如何配置域名强制跳转至https://www且兼容Firefox

原有代码失效原因 #

• 仅判断了域名是否带www前缀，未校验请求是否使用HTTPS协议，http://www.<domain_name>.com这类请求不会被跳转到HTTPS
• 未适配Express部署在反向代理（Nginx、Cloudflare等）后的场景，直接读取协议头会拿到反向代理和应用之间的HTTP协议，判断错误
• 301永久重定向会被浏览器长期缓存，修改逻辑后未清除Firefox缓存会出现旧逻辑依旧生效的假象
• 未处理host头携带端口的特殊场景，跳转后地址会出现拼接错误

正确配置步骤 #

1. 首先在Express入口文件开启代理信任，适配反向代理部署场景：

// 放在所有中间件最前面
app.set('trust proxy', 1);

2. 替换原有重定向中间件为以下逻辑：

app.use((req, res, next) => {
  // 本地开发环境跳过跳转，可根据自身需求调整
  if (req.hostname === 'localhost' || req.hostname === '127.0.0.1') {
    return next();
  }
  const isHttps = req.protocol === 'https';
  const hasWww = req.hostname.startsWith('www.');
  // 已经是HTTPS+www的情况直接放行
  if (isHttps && hasWww) {
    return next();
  }
  // 拼接目标地址：统一转HTTPS+补全www
  const targetHost = hasWww ? req.hostname : `www.${req.hostname}`;
  return res.redirect(301, `https://${targetHost}${req.originalUrl}`);
});

Firefox不生效排查方案 #

• 先清除浏览器缓存：打开Firefox设置→隐私与安全→Cookie和站点数据→清除数据，勾选缓存后清除，重启浏览器再测试
• 如果配置了HSTS，需要检查根域名的HSTS规则是否包含includeSubDomains，避免强制跳转逻辑冲突
• 确认反向代理配置是否正确传递了X-Forwarded-Proto头，保证Express能拿到真实的用户请求协议

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