Node.js+Express搭建HTTPS本地服务器遇ERR_SSL_PROTOCOL_ERROR求助

我之前也踩过这个坑，这个错误大概率是HTTPS服务的配置或者证书环节出了问题，咱们一步步来排查解决：

1. 先排查最常见的端口冲突问题 #

你提到http://localhost:3333能正常访问，同时又想在https://localhost:3333访问——同一个端口绝对不能同时绑定HTTP和HTTPS服务器！

如果你的代码里同时启动了HTTP和HTTPS服务并监听同一个3333端口，会导致其中一个服务无法正常启动，或者浏览器发送HTTPS请求时，实际连接到的是HTTP服务器，自然会触发SSL协议错误。

解决方法：

• 给HTTPS服务换一个端口，比如4433（本地用443端口可能需要管理员权限），然后访问https://localhost:4433
• 或者直接关闭HTTP服务，只启动HTTPS服务监听3333端口

给你一个正确的配置示例：

const express = require('express');
const https = require('https');
const fs = require('fs');

const app = express();

app.get('/', (req, res) => {
  res.send('HTTPS 服务正常运行！');
});

// 加载自签名证书和私钥，确保文件路径正确
const sslOptions = {
  key: fs.readFileSync('./server.key'), // 你的私钥文件路径
  cert: fs.readFileSync('./server.crt') // 你的证书文件路径
};

// 启动HTTPS服务，用独立端口
https.createServer(sslOptions, app).listen(4433, () => {
  console.log('HTTPS服务已启动：https://localhost:4433');
});

// 如果需要保留HTTP服务，可以做自动重定向到HTTPS
// const http = require('http');
// http.createServer((req, res) => {
//   res.writeHead(301, { Location: `https://localhost:4433${req.url}` });
//   res.end();
// }).listen(3333);

2. 验证自签名证书的有效性 #

如果端口没问题，那可能是证书本身的问题，比如证书和私钥不配对，或者生成时参数错误。

确认证书生成命令正确 #

用OpenSSL生成自签名证书时，一定要确保Common Name设置为localhost，命令示例：

# 生成有效期1年的自签名证书，CN必须是localhost
openssl req -x509 -newkey rsa:2048 -nodes -keyout server.key -out server.crt -days 365 -subj "/CN=localhost"

验证证书和私钥是否配对 #

执行以下两个命令，如果输出的MD5值完全一致，说明证书和私钥是匹配的：

openssl x509 -noout -modulus -in server.crt | openssl md5
openssl rsa -noout -modulus -in server.key | openssl md5

如果不一致，重新生成证书即可。

3. 检查Chrome的缓存与证书信任 #

有时候浏览器缓存了旧的SSL会话，或者没正确信任自签名证书，也会导致异常：

• 打开Chrome开发者工具（F12），切换到Network标签，勾选Disable cache，然后强制刷新页面（Ctrl+Shift+R）
• 如果浏览器提示“您的连接不是私密连接”，点击高级 → 继续前往localhost（不安全），手动信任这个自签名证书（下次重启浏览器可能需要再次确认）

4. 用curl验证HTTPS服务状态 #

可以用curl命令测试服务器是否真的在提供HTTPS服务：

curl -v https://localhost:3333

如果返回类似Unknown SSL protocol error，说明该端口跑的是HTTP服务，回到第一步检查端口配置；如果返回self-signed certificate，说明HTTPS服务正常，只是浏览器不信任证书，按第三步操作即可。

总结最可能的原因 #

1. 端口冲突：同一个端口同时绑定了HTTP和HTTPS服务
2. 证书与私钥不匹配：生成证书时出错
3. 证书路径错误：代码里加载的证书文件路径不正确，导致服务器无法初始化SSL连接

先从端口冲突开始排查，这是最容易犯的错误，应该能快速解决问题！

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