Oracle客户端中文显示为问号或方块,根本原因是NLS_LANG未正确配置或未生效;须先查数据库字符集(如AL32UTF8或ZHS16GBK),再按客户端类型严格设置三段式NLS_LANG(如AMERICAN_AMERICA.ZHS16GBK)或JDBC连接参数,确保与客户端实际编码一致。

Oracle客户端中文显示为问号或方块,基本就是 NLS_LANG 没设对,或者设了但根本没生效——不是数据库存错了,是客户端解码时用错了“钥匙”。
查清数据库字符集再动手
不看服务端用什么字符集就配 NLS_LANG,等于拿万能钥匙开保险柜。必须先连上数据库执行:
SELECT VALUE FROM NLS_DATABASE_PARAMETERS WHERE PARAMETER = 'NLS_CHARACTERSET';
常见返回值只有三个:AL32UTF8(Linux/云环境主流)、ZHS16GBK(Windows 中文系统旧部署)、UTF8(已废弃,别选)。注意:NLS_NCHAR_CHARACTERSET 是给 NVARCHAR2 用的,和普通字段无关。
SQL*Plus 命令行乱码:环境变量必须三段齐全且重启终端
Windows CMD 默认用 GBK 编码,但很多人设成 AL32UTF8,结果字节流被错误解码。关键点:
-
NLS_LANG格式必须是LANGUAGE_TERRITORY.CHARACTERSET,例如AMERICAN_AMERICA.ZHS16GBK;只写ZHS16GBK或AMERICAN.ZHS16GBK会被 Oracle 忽略 - 临时生效:在启动
sqlplus前执行set NLS_LANG=AMERICAN_AMERICA.ZHS16GBK - 永久生效要改系统环境变量,但改完必须关掉所有 CMD 窗口再重开——它不继承已有进程的环境
- 注册表里的
NLS_LANG(如HKEY_LOCAL_MACHINESOFTWAREORACLEKEY_OraDb11g_home1)对命令行无效,只影响 PL/SQL Developer 这类 GUI 工具
PL/SQL Developer 不认环境变量:必须手动填三段式值
它完全忽略系统 NLS_LANG 和注册表,只读自己界面配置。路径是:Tools → Preferences → Oracle → Connection → Language。填错一个地方就白忙:
- 值必须完整三段,中间无空格:
SIMPLIFIEDCHINESE_CHINA.ZHS16GBK(注意SIMPLIFIEDCHINESE是一个词,带空格会失效) - 填完必须点 OK 并彻底退出再重进,热加载不生效
- 如果用
plsqldev.bat启动,还要检查脚本里有没有硬编码的set NLS_LANG=...,它会覆盖界面上的设置 - 远程连接时,客户端机器上得装含对应字符集支持的 Instant Client(比如用
ZHS16GBK就不能只装精简版 UTF-8 client)
JDBC 和 Java 应用:NLS_LANG 完全无效,必须改连接 URL
IDE(如 IntelliJ)启动的 JVM 不继承终端环境变量,NLS_LANG 对它毫无意义。唯一可靠方式是在 JDBC URL 里加参数:
- 数据库是
AL32UTF8:?useUnicode=true&characterEncoding=UTF-8 - 数据库是
ZHS16GBK:?useUnicode=true&characterEncoding=GBK(别用GB2312,Oracle 对GBK支持更稳) - Spring Boot 的
application.yml里写 URL 要双写反斜杠:url: jdbc:oracle:thin:@//host:1521/pdb?useUnicode=true\&characterEncoding=UTF-8 - Tomcat 的
context.xml配数据源时,&要写成&,否则 XML 解析失败
最容易被忽略的是:团队常把 NLS_LANG 设在 shell 配置文件里,却用 IDE 直接跑 Java 程序——这时 NLS_LANG 对 JDBC 驱动完全不起作用,必须靠 URL 参数。


















