ora-12541本质是sqlcl无法连接监听器，需先确认lsnrctl status显示ready、listener.ora中host非localhost、tnsnames.ora与监听配置一致，并用tnsping和netstat分层验证。
SQLcl连接报ORA-12541：监听未启动或配置失效
这是SQLcl最常遇到的连接失败原因，不是SQLcl本身问题，而是底层TNS无法建立通道。现象是执行connect user/pass@tns_alias后直接报ORA-12541: TNS: no listener。
关键判断点：SQLcl依赖Oracle客户端网络栈，它不会自己启动监听，只消费已配置好的监听服务。
- 先在服务器端运行
lsnrctl status，确认输出里有Listening Endpoints Summary...且状态为STATUS of the LISTENER is READY - 如果
status命令卡住或提示“not found”，说明ORACLE_HOME未设或路径错误——SQLcl不自动继承Windows服务环境变量，需手动指定 - 检查
$ORACLE_HOME/network/admin/listener.ora中LISTENER段是否绑定正确IP（别用localhost或127.0.0.1，除非SQLcl和DB在同一台机器） - Windows下常见陷阱：
services.msc里OracleOraDB*Listener服务显示“正在运行”，但实际监听进程已僵死——用lsnrctl stop && lsnrctl start强制重启才可靠
SQLcl连接报ORA-12514：服务名不匹配或动态注册失败
错误信息明确说listener does not currently know of service requested，说明监听进程活着，但不知道你要连的那个服务。SQLcl默认走TNS别名解析，不支持直接写host:port/service_name这种JDBC式写法。
必须确保tnsnames.ora里的服务名与数据库实际注册的服务名完全一致（区分大小写，不含空格）。
- 查数据库真实服务名：
SELECT value FROM v$parameter WHERE name = 'service_names'; - 查监听已知服务：
lsnrctl services，输出里Service "xxx" has 1 instance(s)这一行的xxx才是有效值 - SQLcl不读取
sqlnet.ora里的NAMES.DEFAULT_DOMAIN，所以tnsnames.ora中别名必须写全，例如ORCL.example.com不能简写为ORCL - 如果是单实例且使用动态注册（非静态注册），确认数据库
LOCAL_LISTENER参数已设且ALTER SYSTEM REGISTER;执行过
SQLcl启动即报ORA-28000或ORA-28001：密码策略触发锁定或过期
SQLcl本身不做密码校验，所有认证由Oracle服务器完成。报ORA-28000（账号锁定）或ORA-28001（密码过期）时，说明用户状态异常，和SQLcl版本、配置无关。
注意：SQLcl 22.2+ 默认启用密码缓存，若之前成功连过，可能复用旧凭据导致误判——务必加-nolog参数重新输入凭据验证。
- 查锁定状态：
SELECT username, account_status FROM dba_users WHERE username = 'YOUR_USER';，返回LOCKED或EXPIRED(GRACE)即确认 - 密码过期常见于Oracle 11g+默认profile，查限制：
SELECT limit FROM dba_profiles WHERE profile='DEFAULT' AND resource_name='PASSWORD_LIFE_TIME'; - 解锁或重置密码需DBA权限：
ALTER USER your_user ACCOUNT UNLOCK;或ALTER USER your_user IDENTIFIED BY newpass; - SQLcl不支持在连接串里带特殊字符（如
@、/），密码含这些字符必须用双引号包裹：connect scott/"p@ss/w0rd"@orcl
SQLcl连接超时或卡住：客户端网络栈配置缺失
不同于SQL*Plus，SQLcl基于Java运行时，它绕过了部分Oracle Net配置，但也因此丢失了sqlnet.ora的某些控制能力。表现为连接命令无响应、几秒后报ORA-12170: TNS:Connect timeout occurred。
根本原因常是Java无法解析TNS别名，或DNS/hosts文件未生效。
- 强制跳过TNS解析，用Easy Connect语法：
connect user/pass@//host:port/service_name（注意双斜杠） - 确认
tnsnames.ora路径被SQLcl识别：启动时加-debug参数，看日志里Using tnsnames.ora from ...路径是否正确 - Linux/macOS下常见
java.net.UnknownHostException，本质是Java DNS缓存问题，临时解决：export JAVA_TOOL_OPTIONS="-Dnetworkaddress.cache.ttl=0" - Windows防火墙有时拦截Java进程而非Oracle服务，检查出站规则是否放行
java.exe访问1521端口
tnsnames.ora加载失败，只会静默 fallback 到默认解析逻辑，然后报一个看似无关的错误。
