Oracle Net tracing需按问题定位客户端或服务端:连不上(ORA-12154/12545)只配客户端sqlnet.ora,含TRACE_LEVEL_CLIENT=16、TRACE_FILE_CLIENT、TRACE_DIRECTORY_CLIENT;连接后断连则两端均需开启;监听器问题仅服务端配置。
怎么开 Oracle Net tracing(不是 SQL trace)
oracle net tracing 专门抓客户端到数据库监听器之间的网络握手、连接建立、tns 协议交互,和 sql_trace 或 dbms_monitor 完全无关。开错地方就白忙——比如只在数据库端设 sqlnet.ora 却没配客户端,或反过来。
关键判断:你得先确定问题出在哪一端。连不上?是客户端解析 TNSNAMES.ORA 失败?还是监听器根本没响应?还是连接后立刻断开?不同现象对应不同 tracing 级别和位置。
- 客户端连不上(
ORA-12154、ORA-12545)→ 必须在客户端配sqlnet.ora,且确保该文件被实际加载(Oracle 会按顺序找:$ORACLE_HOME/network/admin、$TNS_ADMIN指向路径、当前目录) - 连接成功但应用报超时或断连 → 客户端 + 服务端都要开,对比两边日志时间戳和包序列
- 只关心监听器行为(比如
lsnrctl status不返回)→ 服务端开即可,重点看listener.log和TRACE_LEVEL_LISTENER
sqlnet.ora 里必须写的三行配置
不是加一堆参数就有用,Oracle Net tracing 对配置项敏感,少一个或拼错就静默失效。最简有效组合只有这三项,且顺序无关,但必须都在同一份 sqlnet.ora 中:
-
TRACE_LEVEL_CLIENT = 16(或ADMIN,数值 16 更明确;设成 4 或USER只记极少量事件,基本没用) -
TRACE_FILE_CLIENT = cli.trc(文件名随意,但路径必须客户端进程有写权限;不建议用绝对路径,容易因用户/环境变量失效) -
TRACE_DIRECTORY_CLIENT = /tmp/ora_trace(目录需提前mkdir -p并chmod 755;Oracle 不自动建父目录,写错路径会导致 tracing 彻底不生效,且无任何提示)
注意:TRACE_UNIQUE_CLIENT = ON 在多用户共用客户端时很有用(避免日志混写),但不是必需;LOG_DIRECTORY_CLIENT 控制的是普通日志(如 sqlnet.log),和 tracing 无关,别混淆。
为什么开了 tracing 却没生成 .trc 文件
这是最高频的失败场景,不是配置漏了,就是环境没对上。常见原因:
- 客户端程序没读到你改的
sqlnet.ora—— 比如 Java 应用用的是 JDBC Thin,它压根不读本地sqlnet.ora,得靠连接串加?oracle.net.traceLevel=16或 JVM 参数-Doracle.net.traceLevel=16 - Oracle 进程启动早于
sqlnet.ora修改 → 必须重启客户端工具(sqlplus、tnsping)或应用进程,热加载不生效 - 权限问题:目标
TRACE_DIRECTORY_CLIENT目录属主不是运行客户端的用户,或磁盘满(df -h看一眼) - 误用了服务端参数:比如在客户端
sqlnet.ora里写了TRACE_LEVEL_SERVER,它只对数据库实例进程起作用,客户端进程直接忽略
验证是否生效最简单方法:tnsping your_db_alias 后立刻检查 TRACE_DIRECTORY_CLIENT 下是否有新 .trc 文件生成。没有?说明配置没被加载。
trc 文件太大、滚动慢、难定位关键段
默认 tracing 是全量记录,一次连接可能产生几十 MB 日志,而且全是十六进制+ASCII 混排,人工翻效率极低。实用技巧:
- 不要长期开着 tracing —— 开之前先复现问题,开完立刻关(删掉或注释掉
sqlnet.ora里的 tracing 行) - 用
grep -A 5 -B 5 "NNL" cli.trc快速定位连接建立阶段(NNL是 Net Layer 的标识符);搜"nscon"看连接协商,搜"nstim"看超时事件 - 服务端 tracing 日志默认不压缩也不轮转,
TRACE_FILE_SERVER建议设短名(如srv.trc),并配合TRACE_FILENO_SERVER = 5限制最多保留 5 个文件 - 如果只是查 TNS 解析失败,优先用
tnsping -v your_alias,它会打印实际读取的tnsnames.ora路径和解析结果,比看 trc 快得多
真正麻烦的从来不是开 tracing,而是 client 和 server 两头日志时间不同步、路径权限错位、或者用错了 tracing 主体(比如在 JDBC Thin 场景硬改 sqlnet.ora)。盯住你的实际调用链路,别被文档里的“通用配置”带偏。

















