PDFBOX3+BouncyCastle签名报错：不支持ECPrivateKeyImpl密钥

问题根源 #

你的核心问题是使用了椭圆曲线（EC）密钥证书，但 PDFBox 的 CreateVisibleSignature2 示例默认仅适配 RSA 密钥，同时存在加密提供者不支持 EC 签名、证书扩展密钥用途不符合要求的问题。

分步解决 #

1. 修正签名代码，适配 EC 密钥 #

默认示例代码中存在强制转换为 RSAPrivateKey 及硬编码 RSA 签名算法的逻辑，需修改为支持 EC 密钥的通用逻辑：

// 注册BouncyCastle提供者（放在代码最开头）
Security.addProvider(new BouncyCastleProvider());

// 加载密钥库（以PKCS12为例，JKS同理）
KeyStore keyStore = KeyStore.getInstance("PKCS12", BouncyCastleProvider.PROVIDER_NAME);
keyStore.load(new FileInputStream("your-cert.p12"), "password".toCharArray());

// 获取密钥与证书，不要强制转换为RSAPrivateKey
String alias = keyStore.aliases().nextElement();
PrivateKey privateKey = (PrivateKey) keyStore.getKey(alias, "password".toCharArray());
X509Certificate cert = (X509Certificate) keyStore.getCertificate(alias);

// 根据密钥类型动态选择签名算法
String sigAlgorithm;
if (privateKey.getAlgorithm().equals("EC")) {
    sigAlgorithm = "SHA256withECDSA"; // 或SHA384withECDSA、SHA512withECDSA
} else if (privateKey.getAlgorithm().equals("RSA")) {
    sigAlgorithm = "SHA256withRSA";
} else {
    throw new IllegalArgumentException("不支持的密钥类型");
}

// 初始化签名器时指定算法与BouncyCastle提供者
Signature signature = Signature.getInstance(sigAlgorithm, BouncyCastleProvider.PROVIDER_NAME);
signature.initSign(privateKey);

2. 确保证书扩展密钥用途合规 #

使用 OpenSSL 检查证书的扩展密钥用途（EKU）：

openssl x509 -in your-cert.pem -text -noout

需确认输出中包含**数字签名（Digital Signature）或不可否认（Non Repudiation）**的 OID：

X509v3 Extended Key Usage:
Digital Signature, Non Repudiation

如果缺失，需重新生成证书时添加对应的扩展。例如用 Certbot 生成时，可通过配置文件指定：

[req]
req_extensions = v3_req

[v3_req]
extendedKeyUsage = digitalSignature,nonRepudiation

3. 正确引入 BouncyCastle 依赖 #

在项目 pom.xml 中添加适配 Java 23 的 BouncyCastle 依赖：

<dependency>
    <groupId>org.bouncycastle</groupId>
    <artifactId>bcprov-jdk18on</artifactId>
    <version>1.77</version> <!-- 或最新兼容版本 -->
</dependency>

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