ORDS 22.1安装ORDS_PUBLIC_USER密码校验失败问题咨询

安全阿岳

2026-8-30

问题现象

在Oracle 19c数据库上部署ORDS 22.1.1版本时触发如下报错：

ORA-20202: ERROR: An error occurred during "ORDS_PUBLIC_USER" creation.  
ORA-28003: password verification for the specified password failed  
ORA-06512: at line 65

根据INFO级别安装日志，错误触发于ords_create_rest_users.sql脚本执行阶段，自动生成的ORDS_PUBLIC_USER用户密码无法通过数据库配置的密码策略校验。整个安装流程没有弹出手动设置该用户密码的提示，解压ords.war安装包也无法找到对应SQL脚本核查内置密码生成逻辑。

根因说明

ORDS 22.1.x版本的内置安装SQL没有以明文文件形式直接放在ords.war包根目录，而是打包在核心依赖jar包的资源路径中，因此直接解压war包找不到对应脚本。
默认无交互安装时，ORDS会自动为ORDS_PUBLIC_USER生成仅包含大小写字母、数字的随机密码，一旦目标数据库开启了密码复杂度校验（比如要求密码必须包含特殊字符、长度超过默认生成值、不能包含特定字符等），就会触发ORA-28003密码校验失败错误。

可落地解决方法

按优先级从高到低选择以下方案即可：

方案1：提前手动创建符合密码策略的ORDS_PUBLIC_USER用户
登录ORDS部署的目标数据库（CDB架构请先切换到对应PDB容器），执行如下SQL创建用户，密码设置为完全符合当前库密码策略要求的值：
```
-- 请根据实际环境替换表空间、密码参数
CREATE USER ORDS_PUBLIC_USER IDENTIFIED BY "符合密码策略的自定义密码"
DEFAULT TABLESPACE USERS 
TEMPORARY TABLESPACE TEMP;
GRANT CREATE SESSION TO ORDS_PUBLIC_USER;
```
再正常执行ORDS安装流程即可，安装程序检测到ORDS_PUBLIC_USER已存在时，会跳过自动创建用户、生成随机密码的步骤，直接复用现有用户完成后续配置。
方案2：安装时显式指定用户密码，跳过自动生成逻辑
执行ORDS安装命令时追加--passwords-request参数，启动交互式密码配置流程：
```
# 按实际环境替换数据库连接参数
ords install --admin-user SYS --db-hostname 数据库IP --db-port 1521 --db-servicename 对应服务名 --passwords-request
```
执行后按照交互提示，手动输入符合密码策略的ORDS_PUBLIC_USER密码即可，不会触发自动生成随机密码的逻辑。
方案3：临时放宽密码策略，安装完成后恢复
安装前在目标数据库执行SQL临时关闭密码校验：
```
-- 请在ORDS部署的目标容器下执行
ALTER PROFILE DEFAULT LIMIT PASSWORD_VERIFY_FUNCTION NULL;
```
待ORDS安装完成、服务验证正常后，再将密码校验函数改回原有配置即可。后续也可以手动将ORDS_PUBLIC_USER的密码重置为符合策略的值，同步更新ORDS连接池配置中的对应密码即可，不影响正常运行。

排查注意点

无需费力解压war包查找SQL脚本：22.x版本ORDS的内置安装SQL都打包在ords-core.jar的classpath资源路径下，直接解压war包无法看到明文的ords_create_rest_users.sql，不需要特意反编译或解压jar包核查逻辑，上述三个方案可以100%绕过该问题。
所有数据库端操作必须确认当前容器：如果是CDB架构部署到PDB，执行用户创建、密码策略修改前必须先通过ALTER SESSION SET CONTAINER = 目标PDB名切换到对应容器，否则CDB根容器下的配置对PDB不生效，还是会触发报错。

内容的提问来源于stack exchange，提问作者Paweł Żurkiewicz