FrankenPHP连接超时和端口冲突怎么区分-php教程-PHP中文网

connection refused 表明端口冲突或服务拒绝连接，operation timed out 才是真正的连接超时；前者见于 address already in use 等启动失败，后者表现为 curl 错误 28 或 err_connection_timed_out。

frankenphp连接超时和端口冲突怎么区分

连接超时和端口冲突在 FrankenPHP 启动或请求阶段表现相似（都是“连不上”），但底层原因完全不同，**关键区分点在于错误日志里是否出现 Connection refused 或 Operation timed out**。

前者是端口冲突或服务未监听的明确信号；后者才是真正的连接超时——TCP 握手卡在 SYN_SENT 阶段，等不到响应。

Connection refused：目标地址+端口有响应，但明确拒绝连接。常见于：FrankenPHP 已在运行、端口被其他进程占着、或反向代理（如 Nginx）配置了错误 upstream 地址
Operation timed out（cURL 错误 28）、Connection timed out（mysqli/PDO）、或浏览器显示“ERR_CONNECTION_TIMED_OUT”：发出了 SYN 包，但没收到 SYN-ACK，说明目标端口无服务响应，或中间被防火墙/Docker 网络策略静默丢弃

FrankenPHP 默认监听 127.0.0.1:8080（HTTP）和 127.0.0.1:8443（HTTPS）。启动失败并报 address already in use，不等于一定是端口冲突——也可能是前一次进程没彻底退出，或 systemd 服务残留。

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

先查端口占用：lsof -i :8080 或 ss -tuln | grep ':8080'。如果输出中 PID 是 - 或为空，说明不是常规进程占用，而是内核级绑定（比如前一个 FrankenPHP 进程僵死）
检查 FrankenPHP 是否已在后台运行：ps aux | grep frankenphp，注意看状态列（R 运行中 / Z 僵尸 / <defunct></defunct>）
Docker 场景下，别只查宿主机：进入容器执行 netstat -tuln，确认 0.0.0.0:8080 是否真被监听——FrankenPHP 默认只绑 127.0.0.1，外部无法访问，容易误判为“端口空闲但连不上”

能 curl -v http://127.0.0.1:8080 返回 HTTP 状态码（哪怕 404），说明端口通、FrankenPHP 进程活着；但业务请求却超时，大概率是内部处理链路卡住，不是网络层问题。

检查 PHP 脚本是否陷入无限循环、阻塞 I/O（如未设超时的 fsockopen、file_get_contents）或等待未就绪的扩展（如未配置好 Redis 连接池）
FrankenPHP 的 --workers 数量过小 + 高并发请求会排队，表现为“首字节延迟高”，看起来像超时。用 frankenphp status 查看 active_workers 和 queued_requests
若启用 php_value max_execution_time 或 set_time_limit()，它控制的是脚本执行时间，不影响 FrankenPHP 自身的连接建立；但若脚本里调用了外部服务（如数据库、API），需单独设其客户端超时（如 mysqli_options($mysqli, MYSQLI_OPT_CONNECT_TIMEOUT, 3)）

这是容器网络最典型的“假性故障”：错误提示常是 Connection refused，但实际既不是端口冲突，也不是超时，而是 DNS 解析失败或网络隔离导致。

FrankenPHP 容器默认使用 bridge 网络，mysql 这个 hostname 只在 compose 网络里有效；若用 docker run 单独启 FrankenPHP，host: mysql 会解析失败，必须改用宿主机 IP（host.docker.internal）或自定义网络
检查 /etc/hosts 是否被覆盖：某些基础镜像会清空 hosts，导致 service name 无法解析。可在 FrankenPHP 启动命令前加 cat /etc/hosts 确认
MySQL 容器若只监听 127.0.0.1（而非 0.0.0.0），即使端口映射正确，FrankenPHP 容器也无法访问——因为那是 MySQL 容器自己的回环地址，不是对外接口