maven-java：报错：java.io.IOException: Unknown named curve: 1.2.156.10197

Maven-Java 报错：`java.io.IOException: Unknown named curve: 1.2.156.10197` 解决方案

在使用 Maven 或 Java 项目中处理加密或 SSL 连接时，可能会遇到 java.io.IOException: Unknown named curve: 1.2.156.10197 的报错。该错误通常与 Java 虚拟机（JVM）对某些特定加密算法或椭圆曲线（Elliptic Curve）支持不足有关。此类问题常见于使用中国国家密码标准（SM2/SM3/SM4）时，因为这些标准使用了特定的椭圆曲线。

一、问题原因分析

1.1 椭圆曲线 `1.2.156.10197` 的背景

错误中的 1.2.156.10197 是中国国家商用密码标准（SM2）的相关标识符，代表一种特定的椭圆曲线。这种加密算法广泛应用于中国的安全和加密通信领域，但 Java 的默认 JCE（Java Cryptography Extension）库不包含对该标准的支持。

因此，当 Java 应用尝试使用 SM2 加密算法或处理相关的 SSL/TLS 连接时，由于 JVM 无法识别该椭圆曲线，便会抛出 Unknown named curve 的错误。

1.2 可能的使用场景

HTTPS/SSL 连接：如果服务器使用了基于 SM2 标准的 SSL 证书，客户端在建立 HTTPS 连接时可能会遇到该错误。
数字签名：在需要进行数字签名或验证时，使用 SM2 算法的证书或密钥可能导致该错误。
加密数据处理：使用 SM2/SM3/SM4 算法进行加密或解密操作时，Java 不支持相关的椭圆曲线，导致异常。

二、解决方案

为了处理该错误，通常需要为 JVM 提供对中国商用密码标准的支持。这可以通过引入第三方加密库或配置 JVM 来实现。

2.1 使用 BouncyCastle 库

BouncyCastle 是一个开源的加密库，支持广泛的加密算法，包括 SM2/SM3/SM4。通过引入 BouncyCastle，Java 程序可以支持这些算法和相关的椭圆曲线。

引入 BouncyCastle 依赖

在 Maven 项目中，引入 BouncyCastle 的依赖：

<dependency>
   <groupId>org.bouncycastle</groupId>
   <artifactId>bcprov-jdk15on</artifactId>
   <version>1.70</version> <!-- 使用最新版本 -->
</dependency>
<dependency>
   <groupId>org.bouncycastle</groupId>
   <artifactId>bcpkix-jdk15on</artifactId>
   <version>1.70</version>
</dependency>

在 JVM 中注册 BouncyCastle 提供者

在代码中，将 BouncyCastle 注册为加密提供者：

import org.bouncycastle.jce.provider.BouncyCastleProvider;

import java.security.Security;

public class Main {
   public static void main(String[] args) {
       Security.addProvider(new BouncyCastleProvider());
       // 继续你的程序逻辑
   }
}

这会让 JVM 使用 BouncyCastle 提供的加密算法实现，从而支持 SM2/SM3/SM4 标准。

使用 BouncyCastle 的 API 进行加解密操作

如果需要手动进行加解密操作，BouncyCastle 提供了丰富的 API，可以处理 SM2/SM3/SM4 的加密任务。

2.2 配置 JVM 以支持国密标准

除了使用第三方库，还可以通过配置 JVM 来增加对国密标准的支持。这通常涉及到安装国密标准的 JCE 提供者，如 JCE 的 GMSSL 提供者。

安装国密 JCE 提供者

你可以下载并安装国密相关的 JCE 提供者，例如 GMSSL。安装后，将相关 JAR 文件放入 JVM 的 lib/ext 目录下，并在 java.security 配置文件中注册该提供者。

编辑 $JAVA_HOME/jre/lib/security/java.security 文件，添加以下内容：
```
security.provider.N=com.yourcompany.provider.GMProvider
```
其中 N 是提供者的顺序号，通常应设置为比默认提供者更高的优先级。
验证配置

配置完成后，重启应用，并测试是否能够正常处理 SM2/SM3/SM4 的加解密操作。如果配置正确，java.io.IOException: Unknown named curve: 1.2.156.10197 错误应该会消失。

2.3 通过 OpenSSL 转换证书

如果问题发生在 HTTPS 连接中，由于服务器使用了 SM2 标准的证书，可以考虑使用 OpenSSL 转换证书格式。

生成新的证书：使用 OpenSSL 生成一个标准的 SSL 证书替代 SM2 证书，确保客户端能够正常连接。
重新配置服务器：将新生成的证书配置到服务器上，并确保服务器支持标准的 SSL/TLS 加密算法。

2.4 检查 Java 版本

某些较早版本的 Java 可能无法很好地支持新的加密算法或提供者。考虑升级到最新的 Java 版本，这可能会包含更广泛的加密支持，并减少类似问题的出现。

升级 Java：建议升级到最新的 Java 11 或 Java 17 版本，以获取最新的安全性补丁和加密支持。
检查 JVM 配置：确保 JVM 配置中没有被禁用的加密算法或提供者。

四、总结

java.io.IOException: Unknown named curve: 1.2.156.10197 错误通常与 JVM 对国密标准（如 SM2）的支持不足有关。通过引入 BouncyCastle 库、配置 JVM 支持国密标准、或使用 OpenSSL 转换证书格式，可以有效解决此类问题。