如何在 Golang 中从带密码的私钥 PEM 字符串中解密并加载私钥对象-Golang-PHP中文网

私钥pem含密码时，x509标准函数无法直接解析；需先用pkcs8.unmarshalencryptedprivatekey（pkcs#8加密）或x/crypto/ssh.parserawprivatekeywithpassphrase（pkcs#1加密）解密，再交x509解析，注意密码和pem格式的隐式干扰。

如何在 golang 中从带密码的私钥 pem 字符串中解密并加载私钥对象

私钥 PEM 字符串含密码时，`crypto/x509` 无法直接解析

Go 标准库的 x509.ParsePKCS1PrivateKey、x509.ParsePKCS8PrivateKey 等函数只处理**未加密**的 PEM 块。如果你的 PEM 字符串开头是 -----BEGIN ENCRYPTED PRIVATE KEY----- 或 -----BEGIN RSA PRIVATE KEY----- 且内容被 DES/AES 加密过，直接调用这些函数会 panic 或返回 x509: unknown key type 错误。

必须先用 crypto/x509/pkcs8（Go 1.19+）或 golang.org/x/crypto/pkcs12（PKCS#12）解密，再交给 x509 解析。注意：标准库不支持 PKCS#1 加密格式（即旧式 -----BEGIN RSA PRIVATE KEY----- + Proc-Type: 4,ENCRYPTED），这类需额外用 golang.org/x/crypto/ssh 或第三方库（如 github.com/youmark/pkcs8）。

Go 1.19+ 推荐方案：用 `pkcs8.UnmarshalEncryptedPrivateKey`

这是目前最轻量、无外部依赖的解密方式，仅支持 PKCS#8 加密格式（即 -----BEGIN ENCRYPTED PRIVATE KEY-----）。步骤明确：

用 pem.Decode 提取 PEM Block
调用 pkcs8.UnmarshalEncryptedPrivateKey，传入 PEM 的 Bytes 和密码字节切片（[]byte）
得到解密后的 DER 数据，再用 x509.ParsePKIXPrivateKey 转为接口类型

示例关键片段：

block, _ := pem.Decode([]byte(pemStr))
if block == nil {
    return nil, errors.New("failed to decode PEM")
}
privKey, err := pkcs8.UnmarshalEncryptedPrivateKey(block.Bytes, []byte("your-password"))
if err != nil {
    return nil, err
}
key, err := x509.ParsePKIXPrivateKey(privKey)
if err != nil {
    return nil, err
}

遇到 `-----BEGIN RSA PRIVATE KEY-----` 加密格式怎么办

这种是 PKCS#1 + PEM 加密（OpenSSL 默认输出），标准库和 pkcs8 都不支持。常见错误现象是 pkcs8: only PKCS#8 encrypted private keys supported。

Go语言（Golang）1.26.0

Go语言（Golang）1.26.0版本提供 Go 官方 Windows amd64 MSI 安装包下载入口，版本号 1.26.0，可用于旧项目维护、兼容性测试和指定版本开发环境配置。

下载

可行路径只有两个：

用 golang.org/x/crypto/ssh 的 ssh.ParseRawPrivateKeyWithPassphrase —— 它能处理 PKCS#1 加密的 RSA/ECDSA/Ed25519，但返回的是 ssh.Signer，不是 crypto.Signer，不能直接用于 TLS 或 JWT 签名；需自行封装或转成标准接口
用 github.com/youmark/pkcs8（维护活跃）：它内部实现了 PKCS#1 解密逻辑，返回标准 crypto.PrivateKey，兼容性更好；但引入了第三方依赖

注意：不要尝试用 OpenSSL 命令提前解密再加载——这会暴露密码到进程环境，且破坏程序自动化流程。

密码编码与空格、换行、BOM 容易引发解密失败

解密失败不一定是因为密码错，更可能是输入格式问题：

密码字符串末尾若有不可见字符（比如 Windows 换行 \r\n、UTF-8 BOM），pkcs8 会校验失败；建议用 strings.TrimSpace 处理
PEM 字符串本身如果被 HTML 或日志系统自动转义（如 ---BEGIN...），pem.Decode 会返回 nil；确保传入的是原始 ASCII PEM 内容
某些旧版 OpenSSL 生成的加密密钥使用 3DES-CBC-SHA1，而 Go 的 pkcs8 默认只支持 AES-CBC-SHA256；此时会报 pkcs8: unsupported encryption algorithm —— 这类密钥建议重生成或降级到 github.com/youmark/pkcs8