frankenphp启动报bind: address already in use但lsof -i :8000无输出，主因是udp端口被占，需用sudo lsof -itcp -stcp:listen -iudp -sudp:listen | grep :8000排查，或改用其他端口如:8081。
FrankenPHP 启动报 bind: address already in use，但 lsof -i :8000 没输出
这很常见——你确认端口没被 TCP 进程占用，lsof -i :8000 返回空，可 FrankenPHP 依然启动失败，错误还是 bind: address already in use。根本原因不是 TCP 被占，而是 UDP 绑定了同一端口号。
UDP 和 TCP 是独立协议栈，端口号空间虽相同（0–65535），但系统层面不冲突；然而 FrankenPHP（底层基于 Caddy + Go net 包）在监听时默认启用 SO_REUSEPORT，且部分 Go 版本或 macOS 内核行为下，若同一端口已被 UDP socket 绑定（哪怕只是 bind() 未 connect()），Go 的 net.Listen 可能直接失败，报错却只显示“address already in use”，不提示协议类型。
-
lsof -i :8000默认只查 TCP 连接（实际行为因 macOS 版本略有差异），对 UDP 监听不敏感 - 常见 UDP 占用者：
dns-sd（mDNS/Bonjour）、airportd、某些监控工具或旧版 Docker Desktop 的虚拟网卡服务 - macOS 上
sudo lsof -iUDP -sUDP:LISTEN | grep :8000才能真正定位 UDP 监听者
怎么一次性查清 TCP 和 UDP 端口占用
别分两次敲命令。用一条带协议过滤的 lsof 覆盖全部可能：
sudo lsof -iTCP -sTCP:LISTEN -iUDP -sUDP:LISTEN | grep :8000
加 sudo 是必须的——否则看不到 root 或系统进程；-iTCP 和 -iUDP 显式指定协议；-sTCP:LISTEN 和 -sUDP:LISTEN 分别过滤出真正在监听的 TCP/UDP socket（注意：UDP 的 LISTEN 状态其实是“已 bind 未 connect”，但足够用于排查）。
- 如果输出里有
UDP行，看PID和COMMAND，比如dns-sd或airportd，就基本锁定了 - 临时释放 UDP 端口：对
dns-sd可试sudo kill -9 PID（它通常会自动重启）；对airportd不建议杀，改用其他端口更稳妥 - FrankenPHP 启动时可通过配置显式禁用 UDP 监听（如 Caddyfile 中不配
http/3，或环境变量FRANKENPHP_HTTP3=0）
为什么改端口比硬刚 UDP 占用更实际
macOS 上很多 UDP 监听是系统服务刚需，比如 dns-sd 支撑 AirDrop、Handoff、本地网络发现，强行 kill 可能导致蓝牙、隔空播放异常，甚至 Finder 网络位置变灰。与其花半小时查一个 dns-sd 子进程，不如换端口。
- FrankenPHP 默认监听
:8000，但完全支持任意可用端口，比如./frankenphp serve --addr :8081 - Caddyfile 中写
localhost:8081即可，HTTPS 自动签发不受影响 - 开发阶段用非标准端口（
:8081、:8088、:9222）反而更安全，避免和本地 Nginx、Docker、Valet 等默认端口撞车 - 真正上线部署时，才需要考虑反向代理（Nginx/Caddy 前置）统一收口到
:80/:443，那时 UDP 冲突问题自然消失
FrankenPHP 启动失败时最容易忽略的点
很多人盯着端口查半天，却漏掉两个更隐蔽的触发条件：
-
SO_REUSEPORT开启状态下，多个 FrankenPHP 实例尝试监听同一端口，即使前一个已kill -15，内核 TIME_WAIT 状态残留仍可能阻塞新绑定（尤其 macOS 上默认超时长） - FrankenPHP 二进制文件权限不足（比如从 .zip 解压后没
chmod +x），会导致启动流程卡在初始化阶段，错误日志可能只显示 “failed to listen”，而非具体 bind 错误 - macOS Gatekeeper 对未签名二进制的拦截有时静默发生，表现为进程闪退无日志，此时需右键打开或执行
xattr -d com.apple.quarantine ./frankenphp
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
