Environment variable ORACLE_UNQNAME not defined是Oracle数据库运行时常见的环境变量错误，通常出现在执行数据库启动、关闭、状态查看等操作时，本质是系统未识别到ORACLE_UNQNAME这个必要参数，导致Oracle相关脚本无法获取数据库唯一名称信息。
错误触发场景
该错误一般在以下场景中高频出现：
- 新安装Oracle数据库后首次执行srvctl、sqlplus等命令
- 服务器重启后环境变量配置未持久化，导致参数丢失
- 手动修改环境变量配置文件时误删了ORACLE_UNQNAME相关配置
- 切换数据库实例后未更新对应的环境变量参数
Linux系统下解决方法
临时配置（当前会话生效）
如果只是临时执行一次相关命令，可以直接在终端中执行以下命令设置环境变量，关闭终端后配置会失效：
# 替换为实际的数据库唯一名称，比如orcl export ORACLE_UNQNAME=orcl # 验证参数是否设置成功 echo $ORACLE_UNQNAME
持久化配置（永久生效）
如果需要配置永久生效，需要根据用户使用的shell类型修改对应的配置文件，Oracle常用用户一般是bash shell，修改~/.bash_profile文件即可：
# 编辑bash配置文件 vi ~/.bash_profile # 在文件末尾添加以下内容，替换为实际的数据库唯一名称 export ORACLE_UNQNAME=orcl export ORACLE_BASE=/u01/app/oracle export ORACLE_HOME=$ORACLE_BASE/product/19.3.0/dbhome_1 export PATH=$ORACLE_HOME/bin:$PATH # 保存退出后执行以下命令让配置生效 source ~/.bash_profile # 验证参数 echo $ORACLE_UNQNAME
Windows系统下解决方法
图形界面配置
打开系统环境变量配置页面，步骤如下：
- 右键点击此电脑，选择属性，点击高级系统设置
- 在弹出的窗口中点击环境变量按钮
- 在系统变量区域点击新建，变量名填写ORACLE_UNQNAME，变量值填写数据库唯一名称，比如orcl
- 点击确定保存所有配置，重启命令行窗口后配置生效
命令行临时配置
如果需要临时配置，打开命令行执行以下命令：
# 临时设置环境变量，当前命令行窗口生效 set ORACLE_UNQNAME=orcl # 验证参数 echo %ORACLE_UNQNAME%
验证配置是否生效
配置完成后，可以通过以下方式验证参数是否生效：
- Linux系统执行
echo $ORACLE_UNQNAME，输出配置的数据库唯一名称即为成功 - Windows系统执行
echo %ORACLE_UNQNAME%，输出对应值即为成功 - 执行Oracle相关命令，比如
sqlplus / as sysdba，不再出现该错误提示则配置正确
注意事项
ORACLE_UNQNAME的值需要和数据库的db_unique_name参数保持一致，可以通过以下SQL语句查询数据库的实际唯一名称：
-- 登录数据库后执行查询 select name, db_unique_name from v$database;
如果配置的ORACLE_UNQNAME和db_unique_name不一致，仍然可能出现其他数据库运行异常，需要根据查询结果调整环境变量的值。同时如果是多实例环境，切换实例时需要同步更新ORACLE_UNQNAME的值，避免参数不匹配。
ORACLE_UNQNAMEOracle数据库环境变量配置Linux环境修改时间：2026-06-06 21:39:50