Oracle JDBC连接必须显式指定字符集，否则中文写入易变?；需先查NLS_CHARACTERSET确认库真实编码（如AL32UTF8或ZHS16GBK），再在JDBC URL中加useUnicode=true&characterEncoding=UTF-8，或用oc.setClientCharset("UTF-8")显式设置。
Oracle JDBC 连接必须显式指定字符集，否则默认用数据库 NLS_CHARACTERSET，极易导致中文写入变成 ?。
确认 Oracle 服务端实际字符集
乱码根源常在服务端配置和客户端不一致。不要只看 NLS_LANG 环境变量或 JDBC URL 里的 characterEncoding，先查库真实字符集：
- 执行
SELECT * FROM NLS_DATABASE_PARAMETERS WHERE PARAMETER = 'NLS_CHARACTERSET';，常见返回是AL32UTF8或ZHS16GBK - 若返回
ZHS16GBK，说明库只支持 GBK 编码，Java 端传 UTF-8 字符串必然变? -
AL32UTF8是安全选择，但 JDBC 驱动仍需明确告知“我传的是 UTF-8”
JDBC URL 必须加 useUnicode=true&characterEncoding=UTF-8
仅靠驱动自动检测不可靠，尤其 Oracle 12c+ 默认忽略该参数。URL 示例：
jdbc:oracle:thin:@//host:1521/orcl?useUnicode=true&characterEncoding=UTF-8
-
useUnicode=true是触发字符集解析的开关，缺它characterEncoding不生效 -
characterEncoding=UTF-8告诉驱动：Java 字符串按 UTF-8 编码后发给 Oracle - 注意：Oracle 官方驱动（ojdbc8.jar）其实不认这两个参数——它们是 MySQL 风格参数；但很多项目混用连接池（如 HikariCP），底层会透传或被兼容层处理；更稳妥做法是用 Oracle 原生方式（见下一条）
用 oracle.jdbc.OracleConnection 显式设置客户端字符集
绕过 URL 参数歧义，直接在连接建立后强制声明编码：
JavaStoryDevelop
下载
你接手一个需求时，是不是经常这样："改一个小字段 → 结果把不相关的代码也改了"、"需求说得很模糊 → 做着做着发现跑偏了"、"数据库加个字段 → 上线才发现漏了数据兼容"、"做了个新功能 → 一个月后自己都忘了当时怎么设计的"、"写到一半被中断 → 再回来不知道从哪继续"；这个 Skill 就是专门解决这些问题的。 它会自动探测你的项目环境（JDK、Spring Boot、ORM、数据库、前端框架），记在
立即学习“Java免费学习笔记（深入）”；
Connection conn = DriverManager.getConnection(url, props);
if (conn.isWrapperFor(oracle.jdbc.OracleConnection.class)) {
oracle.jdbc.OracleConnection oc = conn.unwrap(oracle.jdbc.OracleConnection.class);
oc.setClientCharset("UTF-8"); // 关键：必须设成与 Java 字符串一致的编码
}- 此方法对 ojdbc8+ 有效，
setClientCharset是 Oracle 驱动原生 API - 值必须与 Java 源文件、IDE 编码、
String实际内容一致（推荐全程 UTF-8） - 如果数据库是
ZHS16GBK，这里就得设"GBK"，同时 Java 侧字符串也得是 GBK 编码（极不推荐，易出错）
验证写入是否真乱码，还是查询显示问题
很多情况是写入正确，但 SQL*Plus 或某些客户端用错误编码查，显示为 ?：
- 用 PL/SQL Developer 查时，确认菜单
Tools → Preferences → Database → NLS → Language设为AMERICAN_AMERICA.AL32UTF8 - 在 Java 中用
ResultSet.getString()取出后再打印日志，比直接看数据库工具更可信 - 执行
SELECT DUMP(column_name, 1016) FROM table WHERE ...，看十六进制输出：UTF-8 中文应为C2A1类似多字节，若全是3F（问号 ASCII 码）说明写入阶段已失败
最常被忽略的一点：Spring Boot 的 application.yml 里配了 spring.datasource.url，但没同步更新连接池的 connection-init-sql 或初始化回调逻辑，导致 setClientCharset 没被执行。每个连接都得单独设，不是设一次就全局生效。
