部署于Tomcat的ORDS 24无法关联APEX 24问题求助

ORDS 24已在Tomcat上部署完成，可通过http://localhost:8080/ords/访问并重定向至http://localhost/ords/_/landing，但APEX无法正常访问：

1. 数据库端APEX安装无异常，执行以下SQL验证状态为Valid：

SELECT STATUS FROM DBA_REGISTRY WHERE COMP_ID = 'APEX';

2. ORDS 24按要求完成安装，配置命令如下：

set ORDS_HOME=C:\Daten\ORDS\ords
set ORDS_CONFIG=C:\Daten\ORDS\config\ords
set ORDS_LOGS=%ORDS_CONFIG%\logs
set DB_PORT=1521
set DB_SERVICE=db_service1
set SYSDBA_USER=SYS
set SYSDBA_PASSWORD=**********
set ORDS_PASSWORD=123456

%ORDS_HOME%/bin/ords ^
--config %ORDS_CONFIG% install ^
--log-folder %ORDS_LOGS% ^
--admin-user %SYSDBA_USER% ^
--db-hostname db_hostname1 ^
--db-port %DB_PORT% ^
--db-servicename %DB_SERVICE% ^
--feature-db-api true ^
--feature-rest-enabled-sql true ^
--feature-sdw true ^
--gateway-mode proxied ^
--gateway-user APEX_PUBLIC_USER ^
--proxy-user ^
--password-stdin

3. 已解决Tomcat未读取JAVA配置的问题，ORDS可正常启动，但APEX仍无法访问。

• 验证Tomcat中APEX静态文件可正常访问：http://localhost:8080/i/alert.gif能正常打开
• Catalina日志无APEX/ORDS相关访问错误，仅存在其他服务的错误日志
• 确认ORDS 22+已移除ords_params.properties，未在配置路径找到该文件
• 用ORDS/APEX相关用户的连接参数测试数据库连通性，无防火墙或连接问题

1. 检查ORDS与APEX的映射配置 #

ORDS需要明确映射到APEX实例，执行以下SQL确认关联状态：

-- 查看APEX工作区状态
SELECT WORKSPACE, STATUS FROM APEX_WORKSPACES;
-- 确认ORDS是否已注册APEX模块
SELECT * FROM ORDS_METADATA.ORDS_INSTANCES WHERE MODULE = 'APEX';

如果未找到APEX的注册记录，执行ORDS的APEX关联命令：

%ORDS_HOME%/bin/ords --config %ORDS_CONFIG% apex setup --admin-user SYS --db-hostname db_hostname1 --db-port 1521 --db-servicename db_service1

2. 检查APEX_PUBLIC_USER的权限与状态 #

确保APEX_PUBLIC_USER账号未锁定且权限正常：

ALTER USER APEX_PUBLIC_USER ACCOUNT UNLOCK;
GRANT CONNECT, RESOURCE TO APEX_PUBLIC_USER;
-- 确认用户默认表空间配置
SELECT DEFAULT_TABLESPACE FROM DBA_USERS WHERE USERNAME = 'APEX_PUBLIC_USER';

3. 启用ORDS DEBUG日志排查 #

修改Tomcat启动配置，添加JVM参数开启DEBUG日志：

-Dords.debug=true -Dords.debug.level=ALL

重启Tomcat后，访问http://localhost:8080/ords/apex，查看ORDS_LOGS下的日志文件，搜索APEX或404相关错误信息。

4. 验证ORDS状态与模块加载 #

访问http://localhost:8080/ords/ords/status查看ORDS状态信息，确认APEX模块是否已加载。如果状态页未显示APEX相关内容，说明ORDS未正确关联APEX，需重新执行ORDS安装或APEX关联步骤。

5. 检查Tomcat上下文配置 #

确认Tomcat中ords的上下文配置正确，确保ORDS_CONFIG路径在Tomcat环境变量中已正确设置，避免配置加载不全。

内容的提问来源于stack exchange，提问作者Martin Specker