Ubuntu连Oracle失败咋办

Ubuntu 连接 Oracle 数据库失败 原因很多，下面按最常见场景给你一个排查清单 + 解决方案，你可以对照着一步步来。

一、先确认 3 个问题

在排查前，先确认：

Oracle 在哪儿？
- 本地 Ubuntu 上的 Oracle？
- 远程服务器（公司 / 云）？
你用什么连？
- sqlplus
- 程序（Python / Java / PHP）
- 图形工具（DBeaver / Navicat）
报什么错？
- 能把完整错误信息贴出来最好（比如 ORA-xxxxx）

二、网络 & 基础连通性（最常见）

1️⃣ 确认 Oracle 端口是否通

Oracle 默认端口是 1521

telnet IP 1521
# 或
nc -vz IP 1521

❌ 不通 → 说明：

防火墙没放行
Oracle 没启动
IP/端口写错

✅ 通 → 继续往下

2️⃣ 确认 Oracle 监听是否启动（服务器端）

在 Oracle 服务器执行：

lsnrctl status

如果没启动：

lsnrctl start

三、Ubuntu 客户端常见问题

3️⃣ 没装 Oracle 客户端（最常见）

Ubuntu 默认没有 Oracle 客户端

方法一：装 Instant Client（最推荐）

sudo apt update
sudo apt install unzip libaio1

下载：

https://www.oracle.com/database/technologies/instant-client.html

解压后：

export LD_LIBRARY_PATH=/path/to/instantclient
export PATH=$PATH:/path/to/instantclient

4️⃣ sqlplus 连不上

测试：

sqlplus user/password@//IP:1521/服务名

常见错误：

❌ ORA-12170（连接超时）

防火墙
监听没开
IP 错

❌ ORA-12514（服务名不对）

listener does not currently know of service

解决：

select name from v$services;

确认 SERVICE_NAME，不是 SID

四、连接字符串写错（极高概率）

✅ 推荐写法（服务名）

sqlplus user/password@//192.168.1.10:1521/orclpdb

❌ 错误写法

sqlplus user/password@192.168.1.10:1521:orcl

五、字符集 / 编码问题

中文乱码常导致“看起来连不上”

export NLS_LANG=AMERICAN_AMERICA.AL32UTF8

六、程序连接失败（Python / Java）

Python（cx_Oracle / oracledb）

import oracledb
oracledb.init_oracle_client(lib_dir="/path/to/instantclient")

conn = oracledb.connect(
    user="user",
    password="pwd",
    host="IP",
    port=1521,
    service_name="orclpdb"
)