连接本地安装的Oracle数据库服务器，核心就两件事：让客户端找到监听服务，然后以正确的身份验证登录，下面直接从配置检查、连接命令到故障排查，把全流程拆开聊。
连接本地oracle数据库前，先确认这3个基础信息
本地连接听起来简单，但很多人卡在第一步：不知道自己的数据库到底叫什么名字,你至少需要确认以下三项。
- 主机地址：本机连接填
0.0.1或localhost都行，这代表的是回环地址,不会走物理网卡。 - 端口号：Oracle默认监听端口是
1521，安装时如果你改了端口,后面所有连接串都要同步修改。 - 服务名或实例名：这是最容易出错的地方，Oracle 12c以后的版本默认使用多租户架构，有一个CDB根容器和若干个PDB可插拔数据库，默认安装通常生成一个叫
ORCL的CDB和一个叫ORCLPDB1的PDB，客户端连接时填的更多是PDB服务名，orclpdb1,而不是CDB名。
怎么看自己数据库的真实服务名？打开命令行,输入：
sqlplus / as sysdba
进入SQL提示符后执行：
show parameter service_names;
如果看到 service_names 的值是 orclpdb1,那客户端连接串里的服务名就填它。
oracle数据库本地连接不上怎么办？先排查监听和网络配置
遇到连接报错不要急着重装数据库，绝大多数问题出在监听器没有工作,或者配置文件里的名字对不上。
监听没启动的典型症状和解法
本地连接时如果报 ORA-12541: TNS:no listener，意思是客户端向1521端口发请求，但没人应答,先运行监听状态命令：
lsnrctl status
如果你看到类似 The listener supports no services 或者直接提示连接失败，说明监听没起来,启动它：
lsnrctl start
再执行 lsnrctl status，确认出现 Services Summary 并且能看到你数据库的服务名，如果你的数据库实例本身没启动，监听里也会显示不出服务,这时需要先启库：
sqlplus / as sysdba startup
tnsnames.ora配置错误的常见表现
连接本地时虽然很多客户端可以不依赖 tnsnames.ora，但部分工具（比如SQLPlus的简化连接）会读取它，文件位于 $ORACLE_HOME/network/admin/tnsnames.ora,在Windows下通常是：
D:\app\oracle\product\19c\dbhome_1\network\admin\tnsnames.ora用记事本打开，检查里面 HOST 是不是 localhost，PORT 是不是 1521，SERVICE_NAME 是不是和上一步查到的服务名一致，举个例子,正确写法是这样：
ORCLPDB1 =
(DESCRIPTION =
(ADDRESS = (PROTOCOL = TCP)(HOST = localhost)(PORT = 1521))
(CONNECT_DATA =
(SERVER = DEDICATED)
(SERVICE_NAME = ORCLPDB1)
)
)SERVICE_NAME 写成了 ORCL，而实际PDB服务名是 ORCLPDB1，连接时会报 ORA-12514: TNS:listener does not currently know of service requested in connect descriptor。
防火墙拦截本地连接的蹊跷情况
别以为连本地就不会被防火墙拦，Windows自带的防火墙同样会对回环地址的入站连接做过滤，尤其你如果用的是自定义端口，解决办法是在“Windows Defender 防火墙”的高级设置里，新增一条入站规则，允许TCP端口 1521 通信，如果是Linux环境，检查 firewall-cmd --list-ports 或 iptables -L -n。
行业共识认为，本地Oracle连接问题中，监听未启动和服务名不匹配这两类原因占了绝大多数,优先排查它们。
用sqlplus连接本地oracle数据库的两种命令方式
sqlplus是Oracle自带的命令行工具，它最直接,也最能暴露问题本质。
连接本地默认实例的sqlplus命令写法
如果你要连接PDB,语法是：
sqlplus 用户名/密码@localhost:1521/实例名
sqlplus system/123456@localhost:1521/ORCLPDB1
这条命令的含义是：用TCP协议访问本地1521端口，请求名为 ORCLPDB1 的服务，如果登录的是CDB管理员，可以加上 as sysdba：
sqlplus sys/123456@localhost:1521/ORCLPDB1 as sysdba
使用操作系统身份验证的免密连接
如果当前登录用户是Oracle软件的所有者（比如Linux下的oracle用户）,可以不用密码直接进入：
sqlplus / as sysdba
这种方式走的是操作系统认证，对DBA特别方便，如果你装了多个Oracle数据库环境,需要先把环境变量指到正确的主目录：
export ORACLE_HOME=/u01/app/oracle/product/19c/dbhome_1 export ORACLE_SID=ORCLCDB
Windows下对应设置环境变量后重开命令行。
用图形工具连接本地oracle数据库：Navicat和PL/SQL Developer
命令行虽然可靠，但日常写SQL和看数据，图形工具更顺手,这里重点讲两个最常见的。
Navicat连接本地oracle数据库的完整步骤
Navicat连接Oracle前，需要先确认一个隐藏配置：OCI库，没有它,Navicat连Oracle会直接闪一下报错。
打开Navicat，点击“工具” -> “选项” -> “OCI”，将OCI库路径指向你本机Oracle安装目录的 oci.dll 文件，
D:\app\oracle\product\19c\dbhome_1\bin\oci.dll保存后新建连接，类型选Oracle,填写：
- 主机：localhost
- 端口：1521
- 服务名：ORCLPDB1（注意别填SID,除非你明确知道数据库用的是SID模式）
- 用户名：system
- 密码：你自己的密码
填完先点“测试连接”，成功后再保存，如果提示 Oracle Client library cannot be loaded,基本就是OCI路径没配对。
PL/SQL Developer连接前必须配置的路径
PL/SQL Developer不是独立客户端，它依赖本机的Oracle客户端或数据库安装目录，第一次打开登录界面时，点击“取消”进入主界面，然后选择“工具” -> “首选项”，找到“Oracle连接”相关设置，配置 Oracle_Home 和 OCI Library 路径。
Oracle_Home
D:\app\oracle\product\19c\dbhome_1OCI Library 同样是指向 oci.dll，配置好后，重新打开登录框,数据库填：
localhost:1521/ORCLPDB1角色选Normal或SYSDBA，输入用户名密码即可登录，如果仍然报 ORA-12154，说明数据库连接字符串解析失败，回去检查 tnsnames.ora 里的网络别名是否和登录框中填的一致。
本地连接成功后，验证连接并优化体验
连接成功后，先不要急着写业务SQL,跑两个查询确认你连到了对的库：
SELECT instance_name, status FROM v$instance; SELECT name, open_mode FROM v$database;
第一个查询显示实例名和状态，第二个显示数据库整体是否处于 READ WRITE 模式，如果你连的是PDB，V$DATABASE返回的还是CDB信息,这时可以用：
SELECT name, open_mode FROM v$pdbs;
日常使用中，为了提升本地连接体验,可以考虑两个优化动作：
- 把
ORACLE_HOME和TNS_ADMIN环境变量写进系统环境变量,省得每次打开工具都手动配置。 - 用连接描述符简写，在
tnsnames.ora里定义好别名后，sqlplus里直接写别名，sqlplus system@ORCLPDB1,不用每次敲完整IP和端口。
关于本地连接Oracle数据库的常见问答
为什么我本地能ping通，但sqlplus连接报ORA-12541？
ORA-12541表示监听器没在工作，先检查Oracle监听服务是否存在并已启动，Windows下可以打开服务管理器，找到 OracleOraDB19Home1TNSListener 服务，状态是否为“正在运行”，Linux下用 ps -ef | grep tnslsnr 查看进程，监听没起来的直接启动：lsnrctl start。
Navicat连接本地Oracle报ORA-12514是什么意思？
ORA-12514是监听器已响应，但它不认识你请求的服务名，常见原因是连接配置中的服务名和实际服务名不一致，比如填了CDB的 ORCL，但实例的 service_names 是 ORCLPDB1，用 lsnrctl status 查看监听器当前注册的服务列表，里面显示什么名字,就填什么名字。
本地连接Oracle必须要单独安装客户端吗？
如果你要连接的是本机安装的Oracle数据库，不需要额外装客户端，数据库自带的sqlplus和驱动就够用，但如果你要用Navicat或PL/SQL Developer这类工具，它们需要能找到本机的OCI库，因此仍然要配置好路径，如果是远程连接，则需要安装Oracle Instant Client或完整客户端。
首发原创文章，作者：王坚，如若转载，请注明出处：https://idctop.com/article/772894.html
