不支持的字符集 (在类路径中添加 orai18n.jar): ZHS16GBK
- (一)SQL state [99999]; error code [17056]; 不支持的字符集 (在类路径中添加 orai18n.jar): ZHS16GBK; nested exception
- (二)java.sql.SQLException: 不支持的字符集 (在类路径中添加 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): ZHS16GBK at 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$ofVoidMethod2、背景
(ExecutableInvoker.java:115) at org.junit.jupiter.engine.execution.ExecutableInvoker.lambda$invoke@SpringBootTest public 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; i(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(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(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(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(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(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(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(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(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(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(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 com.oracle.database.jdbc (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): ZHS16GBK at 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.doInCallableStatement(ComplexTests.java:110) at org.springframework.jdbc.core.JdbcTemplate.execute(JdbcTemplate.java:1190) ... 68 more21.5.0.0 单元测试类:ComplexTests.java
runtime 引入的 Oracle jdbc 驱动程序是21.5.0.0版本的。
pom.xml
3、原因分析
ojdbc84、解决方案
com.oracle.database.nls 21.5.0.0 引入的Oracle jdbc 驱动程序“不支持的字符集 (在类路径中添加 orai18n.jar): ZHS16GBK”,需要在pom.xml文件中同时引入orai18n.jar包。
true 方案1:
在maven仓库引入 orai18n.jar 包。如下所示,在pom.xml文件中引入 orai18n.jar 包。
下面两种不同来源的orai18n包任选一种即可(推荐第一种,第一种是官方的)。
第一种:
pom.xml
cn.easyproject orai18n12.1.0.2.0 provided 或者:
第二种:
pom.xml
com.oracle.database.jdbc orai18n${oracle-database.version} pom 备注:
一栏不写的话,spring-boot-starter-parent包(以2.7.6版本为例)里面包含的的spring-boot-dependencies包(2.7.6版本为例)里面有默认配置。 spring-boot-dependencies-2.7.6.pom
21.5.0.0 import ojdbc-bomcom.oracle.database.jdbc 11.2.0.4 runtime 方案2:
更换其它较低版本的 Oracle jdbc 驱动程序,那些里面有引入orai18n.jar包(注意这些jar包需要在本地或远程的maven仓库能找到)。下面是更换并测试通过的 Oracle jdbc 驱动程序。
ojdbc6:
11.2.0.4
示例:
com.oracle.database.jdbc ojdbc612.2.0.1 runtime 或者
ojdbc8:
12.2.0.1
18.3.0.0
18.15.0.0
示例:
ojdbc8 二、实验
1、实验操作与分析
12.2.0.1 下面是针对这个上述报错进行过的实验测试。
true 实验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
2、实验结论
orai18ncom.oracle.database.jdbc 21.5.0.0 步骤2:使用高版本的Oracle jdbc 驱动程序进行测试。经测试,引入 orai18n.jar 包后正常。
分析:
当引入的是高版本(19.x.x.x及以上)的Oracle jdbc 驱动程序时,需要同时引入 orai18n.jar 包。
runtime 根据上述两个实验可知:
(1)当引入的是高版本(19.x.x.x及以上)的Oracle jdbc 驱动程序时,由于其不支持的字符集 (在类路径中添加 orai18n.jar): ZHS16GBK,所以需要同时引入 orai18n.jar 包才能正常启动。
用法示例:
pom.xml
com.oracle.database.nls ojdbc821.5.0.0 provided com.oracle.database.jdbc orai18n18.15.0.0 runtime (2)当引入的是低版本(18.x.x.x及以下)的Oracle jdbc 驱动程序时,由于其内部有引入orai18n.jar 包且orai18n.jar 包在本地或远程maven仓库中能找到,所以可以不再需要引入orai18n.jar 也能正常启动。
用法示例:
pom.xml
ojdbc8 三、附录
1、Maven仓库配置(D:\Maven\apache-maven-3.6.3\conf\settings.xml)
D:\Maven\repository true settings.xml
com.your.plugins https://maven.aliyun.com/repository/public https://maven.aliyun.com/nexus/content/groups/public huaweicloud mirror from maven huaweicloud https://repo.maven.apache.org/maven2 repo1 central-1 中央仓库1 https://repo1.maven.org/maven2/ jdk-1.4 1.4 jdk14 runtime (1)Oracle 驱动包:ojdbc8
pom.xml
com.oracle.database.nls ojdbc821.5.0.0 provided (2)Oracle 字符集支持国际化:orai18n
pom.xml
SQL state [99999]; error code [17056]; 不支持的字符集 (在类路径中添加 orai18n.jar): ZHS16GBK;_顾得豹的博客-CSDN博客 orai18n
参考资料