跳到主要内容

Firefox 报 SEC_ERROR_UNKNOWN_ISSUER(颁发者不受信任)的完整排查与修复指南

问题背景与根因:Firefox 为什么不认这张证书

Firefox 使用自带的 NSS 信任库,证书数据存放在配置文件目录下的 cert9.db 与 key4.db 中,默认不读取操作系统的证书存储。因此「系统里已经装好根证书、Chrome 和 Edge 正常、Firefox 却报错」是极常见的现象。SEC_ERROR_UNKNOWN_ISSUER 的字面含义是:NSS 在本地根证书集合中找不到能够签发当前证书链的受信任 CA。触发它基本只有三类根因。

第一类是服务端证书链不完整:服务器只下发了叶子证书,没有附带中间证书。NSS 不像部分客户端那样会主动通过 AIA 扩展去下载中间证书,缺一段就直接判定颁发者未知。第二类是企业 TLS 检查代理替换证书:ZScaler、深信服 AC/AF、Fortinet、Palo Alto 等设备做中间人解密后会动态签发一张由企业根 CA 签发的证书,而这个根 CA 不在 NSS 里。第三类是自签证书或私有 CA:内网服务用 OpenSSL 自建 CA 签发,Firefox 天然不信任。

还有两个容易忽略的因素:根证书本身过期会报 SEC_ERROR_EXPIRED_ISSUER_CERTIFICATE;系统时间偏差过大会让整条链验证失败。有效期规则也要记住:CA/Browser Forum 要求公有 CA 签发的 TLS 证书最长 398 天,Let’s Encrypt 默认 90 天,所以「证书过期」和「链不完整」必须分开排查,不能看到报错就直接重签。

第一步:从证书详情定位真正的颁发者

先点地址栏的锁形图标或警告三角,进入「连接不安全」→「证书」,重点看三个字段:「颁发者(Issuer)」「主题(Subject)」「有效期」。如果颁发者是 ZScaler Root CA、Sangfor SSL Root CA、Fortinet_Factory、Palo Alto Networks Enterprise CA 之类,问题在企业代理;如果颁发者是公司自建 CA 名称,问题在私有 CA;如果颁发者显示 Let’s Encrypt R10/R11、DigiCert、GlobalSign 而 Firefox 仍报错,几乎一定是链不完整。

再用命令行交叉验证,避免被缓存或代理干扰:

openssl s_client -connect www.example.com:443 -servername www.example.com 
  -showcerts /dev/null | openssl x509 -noout -subject -issuer -dates

接着数一下整条链到底发了几张证书:

openssl s_client -connect www.example.com:443 -servername www.example.com 
  -showcerts /dev/null | grep -E "s:|i:"

正常情况下应至少看到两条 s:(叶子证书、中间证书)和两条 i:,且最外层 i: 的内容等于某张受信任根证书的 s:。如果只输出一条 s:,就说明服务端漏发中间证书。另一个快捷入口是在 Firefox 地址栏输入 about:certificate,可以直接查看 NSS 中已导入的证书列表,确认企业根证书是否真的在里面,而不是只装到了系统存储。

服务端链不完整:用 openssl 验证并部署 fullchain

在服务器或任意可连通的目标机器上执行带 CA 校验的连接测试:

openssl s_client -connect www.example.com:443 -servername www.example.com 
  -CAfile /etc/ssl/certs/ca-certificates.crt -verify_return_error </dev/null

关注两行输出:Verify return code: 0 (ok) 说明链能追到受信任根;若出现 verify error:num=21:unable to verify the first certificate,就是典型的缺中间证书。Debian/Ubuntu 的 CA bundle 在 /etc/ssl/certs/ca-certificates.crt,CentOS/RHEL 在 /etc/pki/tls/certs/ca-bundle.crt。

修复方式是部署 fullchain,顺序必须是叶子在前、中间在后,根证书不要打包进去,否则部分客户端会因多余根证书告警:

cat www.example.com.crt intermediate.crt > fullchain.pem
grep -c "BEGIN CERTIFICATE" fullchain.pem   # 应输出 2

Nginx 配置示例:

server {
    listen 443 ssl;
    server_name www.example.com;
    ssl_certificate     /etc/nginx/ssl/fullchain.pem;
    ssl_certificate_key /etc/nginx/ssl/www.example.com.key;
    ssl_protocols       TLSv1.2 TLSv1.3;
    ssl_session_cache   shared:SSL:10m;
}

Apache 2.4.8 及以上直接把 fullchain 交给 SSLCertificateFile;更老的版本需要 SSLCertificateChainFile 单独指定中间证书。改完执行 nginx -t && systemctl reload nginx,再回到 Firefox 用 Ctrl+Shift+R 强制刷新验证。

企业代理场景:把根证书导入 Firefox 的 NSS 信任库

手动导入路径:设置 → 隐私与安全 → 下滑到「证书」→「查看证书」→「证书颁发机构」→「导入」,选择企业根证书文件(.crt/.pem/.der),勾选「信任由此 CA 标识的网站」,确定后重启 Firefox。关键点是:导入只对当前配置文件(profile)生效,profile 路径可在 about:support 的「配置文件目录」一栏看到,换机器、换 profile 都要重做一遍。

Linux 批量操作使用 NSS 工具集的 certutil(需安装 libnss3-tools 或 nss-tools):

PROFILE=$(find ~/.mozilla/firefox -maxdepth 1 -name "*.default-release" | head -1)
certutil -A -n "Sangfor Root CA" -t "C,," -i sangfor-root.crt -d sql:$PROFILE
certutil -L -d sql:$PROFILE | grep -i sangfor

参数说明:-A 表示添加,-n 是昵称且不能重复,-t "C,," 中的 C 表示信任该 CA 用于 SSL 服务端认证,-d sql: 指明新版 cert9.db 格式,-i 指定输入文件。PEM 文本格式需要额外加 -a,DER 二进制格式不加。删除用 certutil -D -n "昵称" -d sql:$PROFILE。若报 certutil: could not create cert: SEC_ERROR_BAD_DER,十有八九是 PEM 文件忘了加 -a。

Windows 终端若希望 Firefox 直接复用系统证书存储,可在 about:config 把 security.enterprise_roots.enabled 设为 true,重启后 Firefox 会读取 Windows 证书存储中的企业根,适合域环境统一部署。

企业批量分发:用 policies.json 统一下发根证书

Firefox 支持 Enterprise Policies 强制策略,配置文件放在安装目录下的 distribution 目录:Windows 为 C:/Program Files/Mozilla Firefox/distribution/policies.json,Linux 为 /usr/lib/firefox/distribution/policies.json,macOS 为 /Applications/Firefox.app/Contents/Resources/distribution/policies.json。

{
  "policies": {
    "Certificates": {
      "ImportEnterpriseRoots": true,
      "Install": [
        "/etc/firefox/certs/sangfor-root.crt",
        "C:/certs/internal-ca.crt"
      ]
    }
  }
}

ImportEnterpriseRoots 让 Firefox 读取操作系统根存储;Install 直接列出证书文件路径,支持绝对路径与变量占位。Windows 路径建议用正斜杠,若使用反斜杠在 JSON 中必须写成双反斜杠,否则解析失败。

生效验证:重启 Firefox,打开 about:policies 查看「当前策略」,Certificates 项应显示 Active;若显示 Error 或整个策略未加载,常见原因是 JSON 语法错误(尾逗号、中文引号)、文件路径不可读或放错了目录。注意 policies.json 属于强制策略,用户在界面里无法再移除这些根证书,只适合受管终端,不要用在个人电脑上。分发层面可配合组策略、Ansible、Jamf 或 Intune 把策略文件与证书一并推送到终端。

三种典型场景对比

场景 典型报错 判断依据 修复方式 影响范围
服务端链不完整 SEC_ERROR_UNKNOWN_ISSUER openssl 只输出一条 s:,报 unable to verify the first certificate 部署 fullchain.pem,叶子在前中间在后 所有浏览器与命令行客户端
企业代理 TLS 检查 SEC_ERROR_UNKNOWN_ISSUER 颁发者为 ZScaler、Sangfor、Fortinet 等 导入企业根 CA 到 NSS 或用 policies.json 下发 仅经过代理的受管终端
自签证书 / 私有 CA SEC_ERROR_SELF_SIGNED_CERT 颁发者与主题相同 改用公有 CA,或把私有根导入 NSS 内网服务与内部用户
根证书过期 SEC_ERROR_EXPIRED_ISSUER_CERTIFICATE 根证书 notAfter 已过 更新根证书并重新签发下级证书 全部依赖该根的终端
系统时间偏差 SEC_ERROR_EXPIRED_CERTIFICATE date 与真实时间相差数天以上 校准 NTP:timedatectl set-ntp true 单台终端

从表中可以看出,SEC_ERROR_UNKNOWN_ISSUER 从来不是「Firefox 的 bug」,而是信任链在某一环断了。排查顺序建议固定为:先看颁发者字段 → 再用 openssl 数链长 → 最后才考虑导入根证书。顺序颠倒会浪费大量时间,比如明明是服务端漏发中间证书,却在每台终端上导入根证书,只是掩盖问题。

常见错误排查(含真实报错)

导入后仍报 SEC_ERROR_UNKNOWN_ISSUER:最常见是导入了另一个 profile。用 about:support 核对「配置文件目录」,或执行 certutil -L -d sql:$PROFILE | grep -i 你的CA名 确认。其次是信任位没设,导入时必须勾选「信任由此 CA 标识的网站」,对应 -t "C,,"。

SEC_ERROR_REUSED_ISSUER_AND_SERIAL:同一个 CA 名称加同一序列号签发了多张不同证书,常见于自建 CA 重装后沿用旧序列号。解决方法是删除 NSS 中的旧证书(certutil -D)或重新生成带随机序列号的证书。

SSL_ERROR_BAD_CERT_DOMAIN:证书链已通过但 SAN 不匹配,检查 CSR 里是否漏了 www 子域,用 openssl x509 -in cert.pem -noout -text | grep -A1 "Subject Alternative Name" 核对。

verify error:num=21:unable to verify the first certificate:服务端缺中间证书,不是客户端问题。反向代理与后端分离时尤其常见,记得在对外那一层配置 fullchain。

SEC_ERROR_BAD_SIGNATURE:证书文件被截断或拼接顺序错误,例如把中间证书放到了叶子前面。用 grep -c "BEGIN CERTIFICATE" fullchain.pem 与 openssl crl2pkcs7 -nocrl -certfile fullchain.pem | openssl pkcs7 -print_certs -noout 逐张核对。

效果验证与长期监控

服务端验证:

openssl s_client -connect www.example.com:443 -servername www.example.com 
  -CAfile /etc/ssl/certs/ca-certificates.crt -verify_return_error </dev/null 2>&1 
  | grep -E "Verify return code|verify error"

期望输出 Verify return code: 0 (ok)。再用 curl 与 testssl.sh 双重确认:

curl -sSI --cacert /etc/ssl/certs/ca-certificates.crt https://www.example.com
./testssl.sh --fast --protocols https://www.example.com

Firefox 端验证:锁形图标变为正常状态,点击可看到完整证书链(叶子 → 中间 → 根);about:certificate 中能看到企业根证书;about:policies 中 Certificates 显示 Active。若三者都正常,说明问题已彻底解决。

长期监控要点:公有 CA 签发的 TLS 证书有效期上限为 398 天,Let’s Encrypt 默认 90 天,务必配置自动续期并定期演练:certbot renew --dry-run。同时给根证书与中间证书单独设置到期提醒,企业代理根证书更换时要同步更新 policies.json 中的证书路径与文件,否则所有终端会在一夜之间集体报错。

常见问题

Chrome 使用操作系统证书存储,Firefox 使用自带的 NSS 信任库(cert9.db)。系统里装好的企业根证书或私有 CA 不会自动进入 NSS,所以表现为 Chrome 正常、Firefox 报错。解决方式是把根证书导入 Firefox 的证书颁发机构,或开启 security.enterprise_roots.enabled。

先确认导入到了当前正在使用的 profile,多配置文件环境下很容易导错;再检查导入时是否勾选了「信任由此 CA 标识的网站」,否则证书存在但没有信任位。命令行可用 certutil -L -d sql:$PROFILE 核对昵称与信任标志是否为 C。

用 openssl s_client -showcerts 输出并统计 s: 的行数,只有一条就是服务端缺中间证书,与客户端无关;有多条但 Firefox 仍报错,则是链顶端的根证书不在 NSS 中,需要导入根证书或改用公有 CA 签发的证书。

可以,但必须纳入统一管理:根证书私钥离线保存,为每台服务器单独签发叶子证书,并把根证书通过 policies.json 或 certutil 分发到所有终端的 NSS。注意根证书自身也有有效期,到期前要提前轮换并重新签发下级证书。

公有 CA 签发的 TLS 证书最长 398 天,Let’s Encrypt 默认 90 天。有效期短意味着过期报错更频繁,遇到 SEC_ERROR_EXPIRED_ISSUER_CERTIFICATE 要先看根证书 notAfter,再检查系统时间是否偏差过大。