frankenphp报“bind: address already in use”主因是双栈机制下ipv4与ipv6共享端口绑定，实际被占多为0.0.0.0:端口而非[::]:端口；windows需用netstat -ano -p tcp查ipv6，macos/linux宜用lsof -itcp -stcp:listen | grep :端口；推荐改用127.0.0.1:端口或显式分离协议监听以规避冲突。
FrankenPHP 启动报 bind: address already in use 且配置了 IPv6 地址
不是 IPv6 本身有问题，而是 FrankenPHP 默认同时监听 IPv4 和 IPv6（双栈），而系统对 ::（IPv6 的通配地址）和 0.0.0.0（IPv4 通配）的绑定行为有隐含约束：若其中一个已由其他进程占用，另一个即使空闲也会失败。常见于你改了 server.address = "[::]:8000" 后仍报错——其实真正被占的是 0.0.0.0:8000，但错误提示不区分协议栈。
为什么 netstat -ano | findstr :8000 查不到 IPv6 占用进程？
Windows 的 netstat 默认只显示 IPv4 连接；要查 IPv6，必须加 -p tcp 或 -p udp 并显式指定协议，否则 LISTENING 状态的 IPv6 套接字可能被忽略。正确命令是：
netstat -ano -p tcp | findstr :8000
如果输出里出现类似 TCP [::]:8000 *:* LISTENING 1234 的行，说明 IPv6 确实被占；但更大概率是你看到的是 0.0.0.0:8000 那一行——此时杀掉 PID=1234 就能一并释放双栈端口。
- macOS/Linux 下用
lsof -iTCP -sTCP:LISTEN -P -n | grep :8000更可靠，它会同时列出 IPv4 和 IPv6 的监听项 - 若只查 IPv6，可加
-i6：例如lsof -i6TCP -sTCP:LISTEN :8000
FrankenPHP 的 [server] address 配置对 IPv4/IPv6 的实际影响
FrankenPHP 使用 Go 的 net/http.Server 底层，其监听逻辑遵循操作系统 socket 行为：
-
address = "127.0.0.1:8000"→ 只绑 IPv4 回环，不影响 IPv6 -
address = "[::1]:8000"→ 只绑 IPv6 回环，不影响 IPv4 -
address = "[::]:8000"或"0.0.0.0:8000"→ 尝试双栈绑定（取决于系统是否启用 IPv6 dual-stack）
注意：[::]:8000 在某些 Windows 版本或禁用 IPv6 的系统上会 fallback 到 IPv4 绑定，但一旦 0.0.0.0:8000 被占，fallback 也失败，错误仍显示为 bind: address already in use。
最稳妥的绕过方式：显式分离 IPv4/IPv6 监听
FrankenPHP 不支持单配置开两个监听器，但你可以用反向代理（如 Caddy/Nginx）做协议分流，或直接改用明确的单协议地址避免冲突：
- 开发时优先用
127.0.0.1:8000—— 兼容性最好，且不会触发 HTTP.sys 抢占（Windows 上[::]:80容易撞上 W3SVC） - 真需 IPv6 测试，改用
[::1]:8000，并确认netsh interface ipv6 show addresses中::1已启用 - 若必须双栈且端口紧张，改端口比调协议更省事：
address = "127.0.0.1:8080"+tls.address = "[::1]:8443"分开配
IPv6 地址格式容易漏掉方括号，[::]:8000 写成 :::8000 会导致解析失败并报错，但错误信息仍是模糊的 “address already in use”——这是最容易被忽略的拼写陷阱。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
