Oracle ORDS Docker容器数据库连接失败求助：已排查常见问题

• 处理密码中的特殊字符：你的密码包含#，Docker环境中这类特殊字符容易被shell解析为注释或截断字符串。尝试用单引号包裹整个连接字符串，比如CONN_STRING='sys/#mypwd#@172.xx.0.xx:1521/ORCLCDB'，或者对#做转义（如\#），确保密码完整传递。

• 指定SYS用户的登录身份：SYS用户默认需要以SYSDBA身份登录，尝试修改连接字符串为sys/#mypwd#@172.xx.0.xx:1521/ORCLCDB as sysdba，确认ORDS是否支持带身份标识的连接格式。

• 在ORDS容器内直接测试连通性：

  1. 进入ORDS容器：docker exec -it <ords容器名> bash
  2. 安装telnet或nc工具（如基于Debian镜像：apt-get update && apt-get install telnet）
  3. 先测端口连通：telnet 172.xx.0.xx 1521，如果不通，说明存在网络防火墙或容器间通信限制；如果能通，用sqlplus（容器内有安装的话）测试登录：sqlplus sys/#mypwd#@172.xx.0.xx:1521/ORCLCDB as sysdba，看是否能成功连接。

• 检查Oracle数据库的监听配置：

  1. 进入Oracle-db容器：docker exec -it <oracle-db容器名> bash
  2. 查看监听状态：lsnrctl status，确认1521端口监听正常，且ORCLCDB服务已注册。
  3. 检查tnsnames.ora文件（通常在$ORACLE_HOME/network/admin/目录），确认ORCLCDB的配置条目正确。

• 验证环境变量是否完整传递：
  执行docker inspect <ords容器名>，查看Env字段，确认CONN_STRING的完整值是否正确传入容器，没有被截断或篡改。

• 用容器名称代替IP地址：两个容器在同一Docker网络，直接用Oracle-db容器的名称（如oracle-db）代替IP，比如CONN_STRING=sys/#mypwd#@oracle-db:1521/ORCLCDB，利用Docker内置DNS解析容器地址，避免IP相关的网络问题。

• 检查版本兼容性：确认ORDS Docker镜像版本与Oracle数据库版本是否兼容，高版本ORDS可能不支持低版本Oracle，反之亦然。

内容的提问来源于stack exchange，提问作者Soren Stirner