怎样在Spring Boot中解决Oracle字符集乱码导致的中文报错？-Oracle-PHP中文网

Oracle连接URL未显式指定字符集会导致中文乱码，因驱动不自动读取NLS_CHARACTERSET，必须根据服务端实际编码（如AL32UTF8或ZHS16GBK）在URL中配置characterEncoding或NLS_LANG，并与useUnicode=true配合；Druid需同步设置serverEncoding和clientEncoding；SQL脚本编码也须单独配置sql-script-encoding以匹配文件真实编码。

Oracle连接URL没带字符集参数，查出来就是乱码

spring boot默认用ojdbc驱动连oracle时，不显式指定客户端字符集，驱动会按服务端默认编码（比如al32utf8或zhs16gbk）协商，但java端可能误判成iso-8859-1。结果select name from user返回"å¼ ä¸‰"这种字节错位串。

必须在JDBC URL里强制声明客户端编码：

jdbc:oracle:thin:@//host:port/service?useUnicode=true&characterEncoding=UTF-8（适用于较新ojdbc8+）
Oracle 11g/12c常用写法：jdbc:oracle:thin:@//host:port/service?NLS_LANG=AMERICAN_AMERICA.AL32UTF8
若数据库实际是GBK（如ZHS16GBK），则改用NLS_LANG=AMERICAN_AMERICA.ZHS16GBK

注意：&要写成&（XML/HTML转义），否则YAML解析失败；NLS_LANG值必须和SELECT userenv('language') FROM dual查出的服务端语言+字符集完全一致。

Druid连接池的`connection-properties`设错，插入就报错

用Druid时，光配URL不够，serverEncoding和clientEncoding必须成对出现且方向明确——前者是Oracle服务端编码，后者是Java客户端期望的编码。

常见错误配置：

只写clientEncoding=GBK，漏掉serverEncoding → 插入中文时报ORA-01401: inserted value too large for column
serverEncoding填成UTF-8，但Oracle实际是ZHS16GBK → 插入后查出来仍是乱码
没加filters=encoding到URL前缀 → 配置完全不生效

正确写法（YAML）：

spring:
  datasource:
    url: jdbc:wrap-jdbc:filters=encoding:jdbc:oracle:thin:@//172.16.100.102:1521/orcl
    type: com.alibaba.druid.pool.DruidDataSource
    druid:
      connection-properties: serverEncoding=ZHS16GBK;clientEncoding=GBK

MyBatis-Plus查出String字段自动转码失败

即使连接层编码正确，MyBatis-Plus默认用StringTypeHandler读取CLOB/VARCHAR2，若数据库字段实际存的是GBK字节流，而JVM默认用UTF-8解码，就会得到"涓?涓?涓?"。

Spring Boot Actuator Analyzer

分析Spring Boot Actuator端点的安全性、健康检查、指标暴露及生产配置——审计信息、健康状态和自定义端点。

下载

两种应对方式：

全局统一：在application.yml加mybatis-plus.configuration.default-scripting-language-driver=org.apache.ibatis.scripting.xmltags.XMLLanguageDriver（无效，此为干扰项，忽略）→ 实际应靠连接层解决
精准修复：确认Oracle服务端字符集后，在Druid或Hikari中严格匹配clientEncoding，**不要依赖MyBatis-Plus自动转码**
临时兜底：在Mapper XML里用#{name,jdbcType=VARCHAR,javaType=string}，避免类型推断偏差

重点：MyBatis-Plus本身不处理字符集转换，它只是把JDBC返回的byte[]交给String构造器——所以根源永远在JDBC连接配置。

Spring Boot启动时SQL脚本执行乱码

如果用spring.datasource.schema或spring.sql.init.schema-locations初始化建表/插数据，脚本里含中文注释或默认值，但脚本文件本身是GBK保存，而Spring Boot默认按UTF-8读取，就会报ORA-00911: invalid character或字段值变成问号。

必须显式指定脚本编码：