Docker容器内PHP8+OCI8用oci_connect连Oracle超时求助

针对你遇到的容器内Oracle连接超时问题，结合外部正常、容器内失败的情况，给你几个排查和解决方向：

• 调整Docker网络模式或连接字符串的主机地址
  默认Docker使用bridge网络时，容器内的localhost指向容器自身，而非宿主机。如果Oracle部署在宿主机上：

  • Windows/macOS环境：把连接字符串里的localhost替换成host.docker.internal，比如host.docker.internal:1521/ORCL
  • Linux环境：启动容器时添加参数--add-host=host.docker.internal:host-gateway，之后用host.docker.internal作为连接地址；或者直接用宿主机的局域网IP（如192.168.1.100）替代localhost
  • 也可以尝试用--network=host模式启动容器，让容器共享宿主机网络，但这种方式安全性稍低，按需选择

• 检查宿主机端口开放状态
  确保Oracle监听的端口（默认1521）在宿主机防火墙/安全组中开放，允许容器所在网络访问。可以临时关闭防火墙测试，或者用命令手动开放：
  Linux：sudo iptables -A INPUT -p tcp --dport 1521 -j ACCEPT
  Windows：在防火墙高级设置中添加入站规则，允许1521端口的TCP连接

• 在容器内测试网络连通性
  进入容器内部，先验证能否连接到宿主机的Oracle端口：

  # 进入目标容器（替换成你的容器名）
  docker exec -it php-oracle-container /bin/bash
  # 测试端口连通性（替换为你的宿主机IP和Oracle端口）
  telnet 192.168.1.100 1521
  # 若容器装有nc工具，也可以用
  nc -zv 192.168.1.100 1521
  

  如果telnet/nc无法连通，说明网络层面存在阻断，优先解决这个问题；如果能连通，再排查OCI8扩展或Oracle端配置

• 检查Oracle监听配置
  确保Oracle监听服务绑定的是所有网卡（0.0.0.0），而非仅localhost。找到Oracle的listener.ora文件（通常在$ORACLE_HOME/network/admin目录下），修改LISTENER配置：

  LISTENER =
    (DESCRIPTION_LIST =
      (DESCRIPTION =
        (ADDRESS = (PROTOCOL = TCP)(HOST = 0.0.0.0)(PORT = 1521))
      )
    )
  

  修改后重启Oracle监听服务：lsnrctl restart

• 排查容器DNS解析问题
  如果连接字符串用的是Oracle主机名而非IP，检查容器能否解析该主机名。可以在容器内ping这个主机名，若解析失败，要么启动容器时添加--add-host=oracle-host:192.168.1.100映射IP，要么在容器的/etc/hosts文件中手动添加对应条目

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