（一）SQL state [99999]； error code [17056]；不支持的字符集 (在类路径中添加 orai18n.jar): ZHS16GBK； nested exception

忘是亡心i 2023-09-25 20:08 11阅读 0赞

> **不支持的字符集 (在类路径中添加 orai18n.jar): ZHS16GBK**
> 
>  *  [（一）SQL state \[99999\]； error code \[17056\]； 不支持的字符集 (在类路径中添加 orai18n.jar): ZHS16GBK； nested exception][SQL state _99999_ error code _17056_ _ _ orai18n.jar_ ZHS16GBK_ nested exception]
>  *  [（二）java.sql.SQLException: 不支持的字符集 (在类路径中添加 orai18n.jar): ZHS16GBK][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$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): 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$3.doInCallableStatement(ComplexTests.java:110)
>     	at org.springframework.jdbc.core.JdbcTemplate.execute(JdbcTemplate.java:1190)
>     	... 68 more
> 
> ### 2、背景 ###
> 
> 单元测试类：ComplexTests.java
> 
>     @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<resultList.size(); i++) {
>                 Map rowMap = (Map) resultList.get(i);
>                 String id = rowMap.get("id").toString();
>                 String name = rowMap.get("name").toString();
>                 System.out.println("id=" + id + ";name=" + name);
>             }
>         }
>     
>     }
> 
> 引入的 Oracle jdbc 驱动程序是21.5.0.0版本的。
> 
> pom.xml
> 
>     
>     		<dependency>
>     			<groupId>com.oracle.database.jdbc</groupId>
>     			<artifactId>ojdbc8</artifactId>
>     			<version>21.5.0.0</version>
>     			<scope>runtime</scope>
>     		</dependency>
> 
> ### 3、原因分析 ###
> 
> 引入的Oracle jdbc 驱动程序“不支持的字符集 (在类路径中添加 orai18n.jar): ZHS16GBK”，需要在pom.xml文件中同时引入orai18n.jar包。
> 
> ### 4、解决方案 ###
> 
> **方案1：**
> 
> 在maven仓库引入 orai18n.jar 包。如下所示，在pom.xml文件中引入 orai18n.jar 包。
> 
> 下面两种不同来源的orai18n包任选一种即可（推荐第一种，第一种是官方的）。
> 
> 第一种：
> 
> pom.xml
> 
>     
>     		
>     		<dependency>
>     			<groupId>com.oracle.database.nls</groupId>
>     			<artifactId>orai18n</artifactId>
>     			<version>21.5.0.0</version>
>     			<optional>true</optional>
>     		</dependency>
> 
> 或者：
> 
> 第二种：
> 
> pom.xml
> 
>     
>     		<dependency>
>     			<groupId>cn.easyproject</groupId>
>     			<artifactId>orai18n</artifactId>
>     			<version>12.1.0.2.0</version>
>     			<scope>provided</scope>
>     		</dependency>
> 
> > 备注：<version> 一栏不写的话，spring-boot-starter-parent包（以2.7.6版本为例）里面包含的的spring-boot-dependencies包（2.7.6版本为例）里面有默认配置。
> > 
> >   
> > spring-boot-dependencies-2.7.6.pom
> > 
> >     
> >       <properties>
> >         <oracle-database.version>21.5.0.0</oracle-database.version>
> >       </properties>
> >     
> >       <dependencyManagement>
> >         <dependencies>
> >           <dependency>
> >             <groupId>com.oracle.database.jdbc</groupId>
> >             <artifactId>ojdbc-bom</artifactId>
> >             <version>${oracle-database.version}</version>
> >             <type>pom</type>
> >             <scope>import</scope>
> >           </dependency>
> >         </dependencies>
> >       </dependencyManagement>
> 
> **方案2：**
> 
> 更换其它较低版本的 Oracle jdbc 驱动程序，那些里面有引入orai18n.jar包（注意这些jar包需要在本地或远程的maven仓库能找到）。下面是更换并测试通过的 Oracle jdbc 驱动程序。
> 
> > ojdbc6：
> > 
> > 11.2.0.4
> > 
> > 示例：
> > 
> >     <dependency>
> >     			<groupId>com.oracle.database.jdbc</groupId>
> >     			<artifactId>ojdbc6</artifactId>
> >     			<version>11.2.0.4</version>
> >     			<scope>runtime</scope>
> >     		</dependency>
> 
> **或者**
> 
> > ojdbc8：  
> > 12.2.0.1  
> > 18.3.0.0  
> > 18.15.0.0
> > 
> > 示例：
> > 
> >     <dependency>
> >     			<groupId>com.oracle.database.jdbc</groupId>
> >     			<artifactId>ojdbc8</artifactId>
> >     			<version>12.2.0.1</version>
> >     			<scope>runtime</scope>
> >     		</dependency>

##  ##

> ## **二、实验** ##
> 
> 下面是针对这个上述报错进行过的实验测试。
> 
> ### 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
> 
>     
>     		<dependency>
>     			<groupId>com.oracle.database.nls</groupId>
>     			<artifactId>orai18n</artifactId>
>     			<version>12.2.0.1</version>
>     			<optional>true</optional>
>     		</dependency>
> 
> 步骤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
> 
>     
>     		<dependency>
>     			<groupId>com.oracle.database.jdbc</groupId>
>     			<artifactId>ojdbc8</artifactId>
>     			<version>21.5.0.0</version>
>     			<scope>runtime</scope>
>     		</dependency>
>     
>     		
>     		<dependency>
>     			<groupId>com.oracle.database.nls</groupId>
>     			<artifactId>orai18n</artifactId>
>     			<version>21.5.0.0</version>
>     			<scope>provided</scope>
>     		</dependency>
> 
> （2）当引入的是低版本（18.x.x.x及以下）的Oracle jdbc 驱动程序时，由于其内部有引入orai18n.jar 包且orai18n.jar 包在本地或远程maven仓库中能找到，所以可以不再需要引入orai18n.jar 也能正常启动。
> 
> 用法示例：
> 
> pom.xml
> 
>     
>     		<dependency>
>     			<groupId>com.oracle.database.jdbc</groupId>
>     			<artifactId>ojdbc8</artifactId>
>     			<version>18.15.0.0</version>
>     			<scope>runtime</scope>
>     		</dependency>

##  ##

> ## 三、附录 ##
> 
> ### 1、Maven仓库配置（D:\\Maven\\apache-maven-3.6.3\\conf\\settings.xml） ###
> 
> settings.xml
> 
>     <?xml version="1.0" encoding="UTF-8"?>
>     
>     
>     
>     
>     <settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
>               xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
>               xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd">
>       
>       
>       <localRepository>D:\Maven\repository</localRepository>
>     
>       
>     
>       
>     
>       
>       <pluginGroups>
>         
>       </pluginGroups>
>     
>       
>       <proxies>
>         
>       </proxies>
>     
>       
>       <servers>
>         
>     
>         
>       </servers>
>     
>       
>       <mirrors>
>         
>     	 
>     	
>         <mirror>
>     	  <id>aliyunmaven</id>
>     	  <mirrorOf>*</mirrorOf>
>     	  <name>阿里云公共仓库</name>
>     	  <url>https://maven.aliyun.com/repository/public</url> 
>     	   
>     	</mirror>
>     	
>     	
>     	
>     	
>     	
>      	<mirror>
>     	  <id>repo</id>
>     	  <mirrorOf>central</mirrorOf>
>     	  <name>中央仓库</name>
>     	  <url>https://repo.maven.apache.org/maven2</url>
>     	</mirror>
>     	
>     	
>     	
>       	<mirror>
>     	  <id>repo1</id>
>     	  <mirrorOf>central-1</mirrorOf>
>     	  <name>中央仓库1</name>
>     	  <url>https://repo1.maven.org/maven2/</url>
>     	</mirror>	
>     		
>     	
>     	
>       </mirrors>
>     
>       
>       <profiles>
>         
>     
>         
>       </profiles>
>     
>       
>     </settings>
> 
> ### 2、Oracle jdbc 驱动程序配置（pom.xml） ###
> 
> （1）Oracle 驱动包：ojdbc8
> 
> pom.xml
> 
>     
>     		<dependency>
>     			<groupId>com.oracle.database.jdbc</groupId>
>     			<artifactId>ojdbc8</artifactId>
>     			<version>21.5.0.0</version>
>     			<scope>runtime</scope>
>     		</dependency>
> 
> （2）Oracle 字符集支持国际化：orai18n
> 
> pom.xml
> 
>     
>     		<dependency>
>     			<groupId>com.oracle.database.nls</groupId>
>     			<artifactId>orai18n</artifactId>
>     			<version>21.5.0.0</version>
>     			<scope>provided</scope>
>     		</dependency>

**参考资料**

*  [SQL state \[99999\]; error code \[17056\]; 不支持的字符集 (在类路径中添加 orai18n.jar): ZHS16GBK;\_顾得豹的博客-CSDN博客][SQL state _99999_ error code _17056_ _ _ orai18n.jar_ ZHS16GBK_-CSDN]
 *  [Oracle启动报错：不支持的字符集 (在类路径中添加 orai18n.jar): ZHS16GBK\_不支持的字符集zhs16gbk\_良心有约的博客-CSDN博客][Oracle_ _ orai18n.jar_ ZHS16GBK_zhs16gbk_-CSDN]

[SQL state _99999_ error code _17056_ _ _ orai18n.jar_ ZHS16GBK_ nested exception]: https://blog.csdn.net/Shipley_Leo/article/details/129826529
[java.sql.SQLException_ _ _ orai18n.jar_ ZHS16GBK]: https://blog.csdn.net/Shipley_Leo/article/details/130018181
[SQL state _99999_ error code _17056_ _ _ orai18n.jar_ ZHS16GBK_-CSDN]: https://blog.csdn.net/qq904274014/article/details/90899925
[Oracle_ _ orai18n.jar_ ZHS16GBK_zhs16gbk_-CSDN]: https://blog.csdn.net/u010164507/article/details/114939071