在MacOS Docker的ol8 FREEPDB1中启动ORDS报错：URLMapping服务缺失

1. 确认ORDS配置指向目标PDB #

ORDS独立模式启动时可能未关联到FREEPDB1，需检查配置文件：

• 进入ORDS配置目录（默认/etc/ords或自定义路径），查看defaults.xml，确认db.servicename为FREEPDB1，db.hostname、db.port与容器内数据库匹配。
• 配置错误则重新设置：

  ords config set db.servicename FREEPDB1
  ords config set db.hostname <容器IP或localhost>
  ords config set db.port 1521
  

2. 验证APEX在FREEPDB1中的有效性 #

确保APEX正确安装且状态正常：

• 登录FREEPDB1的SQL命令行：

  sqlplus sys/<密码>@FREEPDB1 as sysdba
  

• 执行查询检查状态：

  SELECT version FROM apex_release;
  SELECT status FROM dba_registry WHERE comp_id = 'APEX';
  

  若status不为VALID，运行修复脚本：

  @$ORACLE_HOME/apex/apex_validate.sql
  

3. 重新同步ORDS与APEX的关联 #

重新初始化ORDS，确保正确识别APEX的URL映射服务：

• 停止ORDS服务：

  ords stop
  

• 执行安装命令指定目标PDB：

  ords install --pdb FREEPDB1 --admin-user SYS --apex-images $ORACLE_HOME/apex/images
  

4. 规范ORDS启动参数 #

启动时指定完整配置路径，避免作用域错误：

ords serve --config /etc/ords --port 8080

查看启动日志，确认已加载FREEPDB1的相关配置，无异常报错。

5. 清理缓存后重启ORDS #

缓存可能导致服务映射异常，清理后重启：

rm -rf /tmp/ords
ords serve --config /etc/ords --port 8080

内容的提问来源于stack exchange，提问作者Bjarte Brandt