routing-controllers+Express本地开发HTTPS无法访问问题求助

核心排查与修复步骤 #

1. 确认mkcert根证书已安装信任 #

mkcert生成的证书依赖本地根证书才能被浏览器认可，执行以下操作：

• 运行命令 mkcert -install 完成根证书的系统信任存储安装
• 彻底关闭并重启浏览器（Chrome、Firefox等需要完全退出进程，避免缓存影响）

2. 修正HTTPS服务的监听配置 #

确保routing-controllers实例被正确绑定到HTTPS服务器，而非错误地将HTTP服务绑到443端口。示例代码如下：

import express from 'express';
import { createExpressServer } from 'routing-controllers';
import https from 'https';
import fs from 'fs';

// 加载mkcert生成的证书文件
const sslOptions = {
  key: fs.readFileSync('./localhost-key.pem'),
  cert: fs.readFileSync('./localhost.pem'),
};

// 创建routing-controllers的Express实例
const app = createExpressServer({
  controllers: [__dirname + '/controllers/*.ts'], // 替换为你的控制器实际路径
});

// 启动HTTPS服务监听443端口
https.createServer(sslOptions, app).listen(443, () => {
  console.log('HTTPS服务已启动：https://localhost:443');
});

// 注意：不要同时启动HTTP服务监听443端口，会导致协议冲突
// app.listen(443); // 此行必须注释或删除

3. 验证证书的域名匹配性 #

检查证书是否包含localhost和127.0.0.1的域名绑定：

• 运行命令 openssl x509 -in localhost.pem -text -noout
• 确认输出中X509v3 Subject Alternative Name字段包含 DNS:localhost, IP Address:127.0.0.1

4. 清除浏览器SSL缓存与干扰 #

• 清除浏览器缓存：Chrome可在chrome://settings/clearBrowserData中选择“缓存的图片和文件”“Cookie和其他网站数据”后清除
• 尝试用匿名窗口访问，排除浏览器插件或本地缓存的影响

5. 检查端口占用情况 #

确保443端口未被其他HTTP服务占用：

• Windows系统：执行 netstat -ano | findstr ":443"
• macOS/Linux系统：执行 lsof -i :443
  若有其他进程占用，可终止该进程或更换HTTPS端口（如8443）

常见误区提醒 #

• 禁止同时启动HTTP和HTTPS服务监听同一端口，会导致SSL握手失败
• 必须将routing-controllers生成的实例传入HTTPS服务器，而非直接使用原生Express的app实例

内容的提问来源于stack exchange，提问作者Takeshi Tokugawa YD