1. 检查SQL*Plus是否安装
在Debian终端输入sqlplus命令，若提示command not found，说明未安装或环境变量未配置。可通过以下命令安装Oracle Instant Client（包含SQL*Plus）：
sudo apt-get update
sudo apt-get install oracle-instantclient-basic oracle-instantclient-sqlplus
安装后，验证命令是否可用：sqlplus -v（应显示版本信息）。
2. 配置Oracle环境变量
Oracle客户端需正确设置ORACLE_HOME、LD_LIBRARY_PATH和PATH，否则无法找到库文件或可执行文件。编辑~/.bashrc（或/etc/profile.d/oracle.sh全局配置），添加以下内容（替换为实际安装路径，如/opt/oracle/instantclient_21_1）：
export ORACLE_HOME=/opt/oracle/instantclient_21_1
export LD_LIBRARY_PATH=$ORACLE_HOME:$LD_LIBRARY_PATH
export PATH=$ORACLE_HOME/bin:$PATH
保存后执行source ~/.bashrc使配置生效。
3. 验证TNS配置文件
若使用tnsnames.ora（用于解析连接标识符），需确保其路径正确且内容无误。默认路径为$ORACLE_HOME/network/admin，文件内容示例：
ORCL =
(DESCRIPTION =
(ADDRESS = (PROTOCOL = TCP)(HOST = localhost)(PORT = 1521))
(CONNECT_DATA =
(SERVER = DEDICATED)
(SERVICE_NAME = orcl)
)
)
可通过tnsping ORCL测试解析是否成功（显示“OK”则表示正常）。
4. 检查网络与防火墙
若连接远程数据库，需确保Debian系统能访问数据库服务器：
ping <hostname>测试网络连通性；telnet <hostname> 1521（或数据库端口）测试端口是否开放；ufw）或服务器防火墙是否允许该端口通过（如sudo ufw allow 1521/tcp）。5. 确认数据库服务状态
若连接远程数据库，需确保Oracle数据库服务已启动。登录服务器后，执行以下命令：
# 检查数据库实例状态
ps -ef | grep pmon
# 启动数据库（若未启动）
sqlplus / as sysdba
SQL> STARTUP;
# 检查监听器状态
lsnrctl status
# 启动监听器（若未启动）
lsnrctl start
本地数据库需确保ORACLE_SID环境变量设置为实例名（如export ORACLE_SID=orcl）。
6. 处理常见错误
tnsnames.ora中的服务名是否正确，或直接使用完整连接字符串（如sqlplus username/password@//host:port/service_name）。lsnrctl start），检查tnsnames.ora中的主机名、端口是否与数据库配置一致。ALTER USER username IDENTIFIED BY new_password;）。libaio库（sudo apt-get install libaio1），这是Oracle客户端依赖的异步I/O库。7. 其他注意事项
ORACLE_HOME目录有读取权限；$ORACLE_HOME/network/log目录下的日志文件（如sqlnet.log），获取详细错误信息。
