不支持的字符集 (在类路径中添加 orai18n.jar): ZHS16GBK
目录
一、报错解答
1、报错
2、背景
3、原因分析
4、解决方案
二、实验
1、实验操作与分析
2、实验结论
三、附录
1、Maven仓库配置（D:\Maven\apache-maven-3.6.3\conf\settings.xml）
2、Oracle jdbc 驱动程序配置（pom.xml）
一、报错解答
1、报错
org.springframework.jdbc.UncateGorizedsqlException: CallableStatementCallback; uncategorized SQLException; SQL state [99999]; error code [17056]; 不支持的字符集 (在类路径中添加 orai18n.jar): ZHS16GBK; nested exception is java.sql.SQLException: 不支持的字符集 (在类路径中添加 orai18n.jar): ZHS16GBK
详细报错内容如下：
org.springframework.jdbc.UncategorizedSQLException: CallableStatementCallback; uncategorized SQLException; SQL state [99999]; error code [17056]; 不支持的字符集 (在类路径中添加 orai18n.jar): ZHS16GBK; nested exception is java.sql.SQLException: 不支持的字符集 (在类路径中添加 orai18n.jar): ZHS16GBKat org.springframework.jdbc.core.JdbcTemplate.translateException(JdbcTemplate.java:1542)at org.springframework.jdbc.core.JdbcTemplate.execute(JdbcTemplate.java:1206)at com.example.jdbctemplateproject.service.ComplexTests.procedure_oracle(ComplexTests.java:91)at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:62)at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43)at java.lang.reflect.Method.invoke(Method.java:498)at org.junit.platfORM.commons.util.ReflectionUtils.invokeMethod(ReflectionUtils.java:725)at org.junit.jupiter.engine.execution.MethodInvocation.proceed(MethodInvocation.java:60)at org.junit.jupiter.engine.execution.InvocationInterceptorChain$ValidatingInvocation.proceed(InvocationInterceptorChain.java:131)at org.junit.jupiter.engine.extension.TimeoutExtension.intercept(TimeoutExtension.java:149)at org.junit.jupiter.engine.extension.TimeoutExtension.interceptTestableMethod(TimeoutExtension.java:140)at org.junit.jupiter.engine.extension.TimeoutExtension.interceptTestMethod(TimeoutExtension.java:84)at org.junit.jupiter.engine.execution.ExecutableInvoker$ReflectiveInterceptorCall.lambda$ofVoidMethod$0(ExecutableInvoker.java:115)at org.junit.jupiter.engine.execution.ExecutableInvoker.lambda$invoke$0(ExecutableInvoker.java:105)at org.junit.jupiter.engine.execution.InvocationInterceptorChain$InterceptedInvocation.proceed(InvocationInterceptorChain.java:106)at org.junit.jupiter.engine.execution.InvocationInterceptorChain.proceed(InvocationInterceptorChain.java:64)at org.junit.jupiter.engine.execution.InvocationInterceptorChain.chainAndInvoke(InvocationInterceptorChain.java:45)at org.junit.jupiter.engine.execution.InvocationInterceptorChain.invoke(InvocationInterceptorChain.java:37)at org.junit.jupiter.engine.execution.ExecutableInvoker.invoke(ExecutableInvoker.java:104)at org.junit.jupiter.engine.execution.ExecutableInvoker.invoke(ExecutableInvoker.java:98)at org.junit.jupiter.engine.descriptor.TestMethodTestDescriptor.lambda$invokeTestMethod$7(TestMethodTestDescriptor.java:214)at org.junit.platform.engine.support.hierarchical.ThrowableCollector.execute(ThrowableCollector.java:73)at org.junit.jupiter.engine.descriptor.TestMethodTestDescriptor.invokeTestMethod(TestMethodTestDescriptor.java:210)at org.junit.jupiter.engine.descriptor.TestMethodTestDescriptor.execute(TestMethodTestDescriptor.java:135)at org.junit.jupiter.engine.descriptor.TestMethodTestDescriptor.execute(TestMethodTestDescriptor.java:66)at org.junit.platform.engine.support.hierarchical.nodeTestTask.lambda$executeRecursively$6(NodeTestTask.java:151)at org.junit.platform.engine.support.hierarchical.ThrowableCollector.execute(ThrowableCollector.java:73)at org.junit.platform.engine.support.hierarchical.NodeTestTask.lambda$executeRecursively$8(NodeTestTask.java:141)at org.junit.platform.engine.support.hierarchical.Node.around(Node.java:137)at org.junit.platform.engine.support.hierarchical.NodeTestTask.lambda$executeRecursively$9(NodeTestTask.java:139)at org.junit.platform.engine.support.hierarchical.ThrowableCollector.execute(ThrowableCollector.java:73)at org.junit.platform.engine.support.hierarchical.NodeTestTask.executeRecursively(NodeTestTask.java:138)at org.junit.platform.engine.support.hierarchical.NodeTestTask.execute(NodeTestTask.java:95)at java.util.ArrayList.forEach(ArrayList.java:1249)at org.junit.platform.engine.support.hierarchical.SameThreadHierarchicalTestExecutorService.invokeAll(SameThreadHierarchicalTestExecutorService.java:41)at org.junit.platform.engine.support.hierarchical.NodeTestTask.lambda$executeRecursively$6(NodeTestTask.java:155)at org.junit.platform.engine.support.hierarchical.ThrowableCollector.execute(ThrowableCollector.java:73)at org.junit.platform.engine.support.hierarchical.NodeTestTask.lambda$executeRecursively$8(NodeTestTask.java:141)at org.junit.platform.engine.support.hierarchical.Node.around(Node.java:137)at org.junit.platform.engine.support.hierarchical.NodeTestTask.lambda$executeRecursively$9(NodeTestTask.java:139)at org.junit.platform.engine.support.hierarchical.ThrowableCollector.execute(ThrowableCollector.java:73)at org.junit.platform.engine.support.hierarchical.NodeTestTask.executeRecursively(NodeTestTask.java:138)at org.junit.platform.engine.support.hierarchical.NodeTestTask.execute(NodeTestTask.java:95)at java.util.ArrayList.forEach(ArrayList.java:1249)at org.junit.platform.engine.support.hierarchical.SameThreadHierarchicalTestExecutorService.invokeAll(SameThreadHierarchicalTestExecutorService.java:41)at org.junit.platform.engine.support.hierarchical.NodeTestTask.lambda$executeRecursively$6(NodeTestTask.java:155)at org.junit.platform.engine.support.hierarchical.ThrowableCollector.execute(ThrowableCollector.java:73)at org.junit.platform.engine.support.hierarchical.NodeTestTask.lambda$executeRecursively$8(NodeTestTask.java:141)at org.junit.platform.engine.support.hierarchical.Node.around(Node.java:137)at org.junit.platform.engine.support.hierarchical.NodeTestTask.lambda$executeRecursively$9(NodeTestTask.java:139)at org.junit.platform.engine.support.hierarchical.ThrowableCollector.execute(ThrowableCollector.java:73)at org.junit.platform.engine.support.hierarchical.NodeTestTask.executeRecursively(NodeTestTask.java:138)at org.junit.platform.engine.support.hierarchical.NodeTestTask.execute(NodeTestTask.java:95)at org.junit.platform.engine.support.hierarchical.SameThreadHierarchicalTestExecutorService.submit(SameThreadHierarchicalTestExecutorService.java:35)at org.junit.platform.engine.support.hierarchical.HierarchicalTestExecutor.execute(HierarchicalTestExecutor.java:57)at org.junit.platform.engine.support.hierarchical.HierarchicalTestEngine.execute(HierarchicalTestEngine.java:54)at org.junit.platform.launcher.core.EngineExecutionOrchestrator.execute(EngineExecutionOrchestrator.java:107)at org.junit.platform.launcher.core.EngineExecutionOrchestrator.execute(EngineExecutionOrchestrator.java:88)at org.junit.platform.launcher.core.EngineExecutionOrchestrator.lambda$execute$0(EngineExecutionOrchestrator.java:54)at org.junit.platform.launcher.core.EngineExecutionOrchestrator.withInterceptedStreams(EngineExecutionOrchestrator.java:67)at org.junit.platform.launcher.core.EngineExecutionOrchestrator.execute(EngineExecutionOrchestrator.java:52)at org.junit.platform.launcher.core.DefaultLauncher.execute(DefaultLauncher.java:114)at org.junit.platform.launcher.core.DefaultLauncher.execute(DefaultLauncher.java:86)at org.junit.platform.launcher.core.DefaultLauncherSession$DelegatingLauncher.execute(DefaultLauncherSession.java:86)at org.junit.platform.launcher.core.SessionPerRequestLauncher.execute(SessionPerRequestLauncher.java:53)at com.intellij.junit5.JUnit5ideaTestRunner.startRunnerWithArgs(JUnit5IdeaTestRunner.java:71)at com.intellij.rt.junit.IdeaTestRunner$Repeater.startRunnerWithArgs(IdeaTestRunner.java:33)at com.intellij.rt.junit.JUnitStarter.prepareStreamsAndStart(JUnitStarter.java:235)at com.intellij.rt.junit.JUnitStarter.main(JUnitStarter.java:54)Caused by: java.sql.SQLException: 不支持的字符集 (在类路径中添加 orai18n.jar): ZHS16GBKat oracle.sql.CharacterSetUnknown.failCharsetUnknown(CharacterSetFactoryThin.java:240)at oracle.sql.CharacterSetUnknown.convert(CharacterSetFactoryThin.java:201)at oracle.jdbc.driver.PhysicalConnection.throughDbCharset(PhysicalConnection.java:11043)at oracle.jdbc.driver.PhysicalConnection.enquoteIdentifier(PhysicalConnection.java:11123)at oracle.jdbc.driver.OracleStatement.enquoteIdentifier(OracleStatement.java:6788)at oracle.jdbc.driver.OracleStatement.getColumnIndex(OracleStatement.java:4211)at oracle.jdbc.driver.InsensitiveScrollableResultSet.findColumn(InsensitiveScrollableResultSet.java:299)at oracle.jdbc.driver.GeneratedResultSet.getString(GeneratedResultSet.java:662)at com.example.jdbctemplateproject.service.ComplexTests$3.doInCallableStatement(ComplexTests.java:110)at org.springframework.jdbc.core.JdbcTemplate.execute(JdbcTemplate.java:1190)... 68 more
2、背景
单元测试类：ComplexTests.java
@SpringBootTestpublic class ComplexTests { @Autowired private JdbcTemplate jdbcTemplate; @Test void procedure_oracle() { List resultList = (List) jdbcTemplate.execute( new CallableStatementCreator() { @Override public CallableStatement createCallableStatement(Connection con) throws SQLException { String storedPoc = "{call pro_query_emp_limit(?,?,?)}"; // 调用的sql CallableStatement cs = con.prepareCall(storedPoc); cs.setInt(1, 4); // 设置输入参数的值 cs.setInt(2, 3); // 设置输入参数的值 cs.reGISterOutParameter(3, OracleTypes.CURSOR); // 注册输出参数的类型 return cs; } }, new CallableStatementCallback() { @Override public Object doInCallableStatement(CallableStatement cs) throws SQLException, DataAccessException { List resultsMap = new ArrayList(); cs.execute(); ResultSet rs = (ResultSet) cs.getObject(3); //获取游标一行的值 while(rs.next()) { // 转换每行的返回值到 Map 中 Map rowMap = new HashMap(); rowMap.put("id", rs.getString("empno")); rowMap.put("name", rs.getString("ename")); resultsMap.add(rowMap); } rs.close(); return resultsMap; } } ); for (int i=0; icom.oracle.database.jdbcojdbc821.5.0.0runtime
3、原因分析
引入的Oracle jdbc 驱动程序“不支持的字符集 (在类路径中添加 orai18n.jar): ZHS16GBK”，需要在pom.xml文件中同时引入orai18n.jar包。
4、解决方案
方案1：
在Maven仓库引入 orai18n.jar 包。如下所示，在pom.xml文件中引入 orai18n.jar 包。
下面两种不同来源的orai18n包任选一种即可（推荐第一种，第一种是官方的）。
第一种：
pom.xml
com.oracle.database.nlsorai18n21.5.0.0true
或者：
第二种：
pom.xml
cn.easyprojectorai18n12.1.0.2.0provided
备注： 一栏不写的话，spring-boot-starter-parent包（以2.7.6版本为例）里面包含的的spring-boot-dependencies包（2.7.6版本为例）里面有默认配置。
spring-boot-dependencies-2.7.6.pom
21.5.0.0 com.oracle.database.jdbc ojdbc-bom ${oracle-database.version} pom import
方案2：
更换其它较低版本的 Oracle jdbc 驱动程序，那些里面有引入orai18n.jar包（注意这些jar包需要在本地或远程的maven仓库能找到）。下面是更换并测试通过的 Oracle jdbc 驱动程序。
ojdbc6：
2.0.4
示例：
com.oracle.database.jdbcojdbc611.2.0.4runtime
或者
ojdbc8：
12.2.0.1
18.3.0.0
18.15.0.0
示例：
com.oracle.database.jdbcojdbc812.2.0.1runtime
二、实验
下面是针对这个上述报错进行过的实验测试。
1、实验操作与分析
实验1：Oracle jdbc 驱动程序版本测试
操作：
（1）高版本测试：经测试，当启动Spring Boot 进行单元测试时，版本19.x.x.x ~ 21.x.x.x 的 Oracle jdbc 驱动程序包会出现上述报错。
（2）低版本测试：经测试，其他一些低版本（18.x.x.x及以下）的 Oracle jdbc 驱动程序则正常（备注：这些低版本的 Oracle jdbc 驱动程序，内部有引入orai18n.jar 包，且在本地或远程maven仓库中能找到）。
分析：
Oracle jdbc 驱动程序，高、低版本中有所差异，19.x.x.x及以上的高版本没有引入orai18n.jar 包 或者 引入了但是在本地和远程仓库都无法找到。
实验2：在pom.xml文件中引入 orai18n.jar 包
操作：
步骤1：在pom.xml文件中引入 orai18n.jar 包，如下：
pom.xml
com.oracle.database.nlsorai18n12.2.0.1true
步骤2：使用高版本的Oracle jdbc 驱动程序进行测试。经测试，引入 orai18n.jar 包后正常。
分析：
当引入的是高版本（19.x.x.x及以上）的Oracle jdbc 驱动程序时，需要同时引入 orai18n.jar 包。
2、实验结论
根据上述两个实验可知：
（1）当引入的是高版本（19.x.x.x及以上）的Oracle jdbc 驱动程序时，由于其不支持的字符集 (在类路径中添加 orai18n.jar): ZHS16GBK，所以需要同时引入 orai18n.jar 包才能正常启动。
用法示例：
pom.xml
com.oracle.database.jdbcojdbc821.5.0.0runtimecom.oracle.database.nlsorai18n21.5.0.0provided
（2）当引入的是低版本（18.x.x.x及以下）的Oracle jdbc 驱动程序时，由于其内部有引入orai18n.jar 包且orai18n.jar 包在本地或远程maven仓库中能找到，所以可以不再需要引入orai18n.jar 也能正常启动。
用法示例：
pom.xml
com.oracle.database.jdbcojdbc818.15.0.0runtime
三、附录
1、Maven仓库配置（D:\Maven\apache-maven-3.6.3\conf\settings.xml）
settings.xml
D:\Maven\repository aliyunmaven * 阿里云公共仓库 https://maven.aliyun.com/repository/public repo central 中央仓库 https://repo.maven.apache.org/maven2 repo1 central-1 中央仓库1 https://repo1.maven.org/maven2/
2、Oracle jdbc 驱动程序配置（pom.xml）
（1）Oracle 驱动包：ojdbc8
pom.xml
com.oracle.database.jdbcojdbc821.5.0.0runtime
（2）Oracle 字符集支持国际化：orai18n
pom.xml
com.oracle.database.nlsorai18n21.5.0.0provided
参考资料
来源地址：https://blog.csdn.net/Shipley_Leo/article/details/129826529
0