启动Node.js v14.15.1服务器时PFX证书报header too long错误如何解决？

问题详情 #

启动Node.js v14.15.1版本服务器时，使用PFX格式证书触发如下错误：

> node app.js
tls_common.js:273
       c.context.loadPKCS12(buf);
Error: header too long
at Object.createSecureContext (_tls_common.js:273:19)
at Server.setSecureContext (_tls_wrap.js:1323:27)
at Server (_tls_wrap.js:1181:8)
at new Server (https.js:66:14)

服务器核心代码如下：

const { readFileSync } = require('fs');
const pfx = readFileSync(__dirname + '/src/certs/cert.pfx');
const pid = process.pid

const express = require('express');
const app = express();
app.get('/', function (req, res) {
  console.log('/')
  res.send(`${pid}`);
});
const { createServer } = require('https');

const { createRoutes } = require('./src/routes/index');
const { createSocket } = require('./src/core/socket');

const https = createServer({
  pfx: pfx,
  passphrase: '',
}, app);

const io = createSocket(https);
createRoutes(app, io);

const PORT = process.env.PORT || 5005; // 8443

https.listen(PORT, () => {
  console.log(`https server started on port:${PORT}`);
});

报错原因 #

1. PFX文件损坏或读取异常：读取的PFX文件本身已损坏，或者路径错误导致读取了非PFX格式的文件（比如空文件、文本文件），使得Node.js无法解析证书结构。
2. 密码配置异常：代码中passphrase设为空字符串，但该PFX证书实际带有密码；或者Node.js v14对空密码参数的处理存在兼容性问题，干扰了证书解析流程。
3. 文件权限不足：运行Node.js的用户没有PFX文件的读取权限，导致readFileSync仅读取了部分内容，证书解析时出现头部过长错误。

解决方法 #

• 验证PFX文件有效性
  使用openssl工具检查文件是否正常：

  openssl pkcs12 -info -in ./src/certs/cert.pfx
  

  执行后若要求输入密码则对应输入，若命令报错说明文件损坏，需重新生成或获取正确的PFX证书。

• 确认文件路径正确性
  在代码中添加路径打印，验证读取的文件路径是否正确：

  const certPath = __dirname + '/src/certs/cert.pfx';
  console.log('证书路径：', certPath);
  const pfx = readFileSync(certPath);
  

  确保路径指向的是真实存在的PFX文件，避免路径拼接错误。

• 调整密码配置

  • 若PFX证书有密码，将passphrase改为正确的密码值；
  • 若确认证书无密码，删除passphrase配置项，不传入该参数：

    const https = createServer({
      pfx: pfx
    }, app);
    

• 修复文件权限
  Linux/macOS环境下，调整PFX文件权限确保可读取：

  chmod 644 ./src/certs/cert.pfx
  

  Windows环境下，右键文件选择“属性”-“安全”，确保当前用户拥有读取权限。

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