(一)SQL state [99999]; error code [17056]; 不支持的字符集 (在类路径中添加 orai18n.jar): ZHS16GBK; nested exception
作者:mmseoamin日期:2023-12-14

不支持字符集 (在类路径中添加 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$ofVoidMethod

2、背景

(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		
		
			

3、原因分析

ojdbc8

4、解决方案

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
			orai18n
			12.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-bom
        com.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
			ojdbc6
			12.2.0.1
			runtime
		

或者

 ojdbc8:

12.2.0.1

18.3.0.0

18.15.0.0

示例:

		
			

ojdbc8

二、实验

1、实验操作与分析

com.oracle.database.nls
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、实验结论

orai18n com.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
			ojdbc8
			21.5.0.0
			provided
		
		
		
			com.oracle.database.jdbc
			orai18n
			18.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)

/path/to/local/repo
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
			ojdbc8
			21.5.0.0
			provided
		

(2)Oracle 字符集支持国际化:orai18n

pom.xml

		
		
			
  • SQL state [99999]; error code [17056]; 不支持的字符集 (在类路径中添加 orai18n.jar): ZHS16GBK;_顾得豹的博客-CSDN博客
  • orai18n

     

    参考资料

    • Oracle启动报错:不支持的字符集 (在类路径中添加 orai18n.jar): ZHS16GBK_不支持的字符集zhs16gbk_良心有约的博客-CSDN博客