(一)SQL state [99999]; error code [17056]; 不支持的字符集 (在类路径中添加 orai18n.jar): ZHS16GBK; nested exception
不支持的字符集 (在类路径中添加 orai18n.jar): ZHS16GBK
目录
1、Maven仓库配置(D:\Maven\apache-maven-3.6.3\conf\settings.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; i
引入的 Oracle jdbc 驱动程序是21.5.0.0版本的。
pom.xml
com.oracle.database.jdbc ojdbc8 21.5.0.0 runtime 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.nls orai18n 21.5.0.0 true 或者:
第二种:
pom.xml
cn.easyproject orai18n 12.1.0.2.0 provided 备注:
一栏不写的话,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.jdbc ojdbc6 11.2.0.4 runtime 或者
ojdbc8:
12.2.0.1
18.3.0.0
18.15.0.0示例:
com.oracle.database.jdbc ojdbc8 12.2.0.1 runtime
二、实验
下面是针对这个上述报错进行过的实验测试。
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.nls orai18n 12.2.0.1 true 步骤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.jdbc ojdbc8 21.5.0.0 runtime com.oracle.database.nls orai18n 21.5.0.0 provided (2)当引入的是低版本(18.x.x.x及以下)的Oracle jdbc 驱动程序时,由于其内部有引入orai18n.jar 包且orai18n.jar 包在本地或远程maven仓库中能找到,所以可以不再需要引入orai18n.jar 也能正常启动。
用法示例:
pom.xml
com.oracle.database.jdbc ojdbc8 18.15.0.0 runtime
三、附录
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.jdbc ojdbc8 21.5.0.0 runtime (2)Oracle 字符集支持国际化:orai18n
pom.xml
com.oracle.database.nls orai18n 21.5.0.0 provided
参考资料
- SQL state [99999]; error code [17056]; 不支持的字符集 (在类路径中添加 orai18n.jar): ZHS16GBK;_顾得豹的博客-CSDN博客
- Oracle启动报错:不支持的字符集 (在类路径中添加 orai18n.jar): ZHS16GBK_不支持的字符集zhs16gbk_良心有约的博客-CSDN博客
来源地址:https://blog.csdn.net/Shipley_Leo/article/details/129826529
免责声明:
① 本站未注明“稿件来源”的信息均来自网络整理。其文字、图片和音视频稿件的所属权归原作者所有。本站收集整理出于非商业性的教育和科研之目的,并不意味着本站赞同其观点或证实其内容的真实性。仅作为临时的测试数据,供内部测试之用。本站并未授权任何人以任何方式主动获取本站任何信息。
② 本站未注明“稿件来源”的临时测试数据将在测试完成后最终做删除处理。有问题或投稿请发送至: 邮箱/279061341@qq.com QQ/279061341