“cannot assign requested address”错误主因是绑定的IP地址未配置在本机网卡上，如云服务器误配公网IP、WSL2中绑定Windows主机IP、或localhost解析为IPv6::1而服务仅支持IPv4；应改用127.0.0.1、0.0.0.0或ip addr实际显示的内网IP。
不是端口占用，而是地址绑定失败 —— 最常见原因是绑定了一个本机不存在的 IP 地址。
为什么 cannot assign requested address 不等于端口被占
这个错误来自系统调用 bind() 失败，内核明确拒绝了地址请求。它和 address already in use（端口被占）是两类不同错误：
-
address already in use：端口+IP 组合已被其他进程监听，冲突在“占用” -
cannot assign requested address：你指定的 IP 根本没配在任何网卡上，或者该地址不可路由（比如写了云服务器的公网 IP，但系统只认127.0.0.1或内网 IP）
FrankenPHP 默认监听 127.0.0.1:8080，但如果配置里写成 192.168.100.50:8080 或 114.114.114.114:8080，而本机没有对应网卡或路由，就会直接报这个错。
检查 FrankenPHP 配置中的 address 是否合法
打开你的 frankenphp.toml 或启动命令里的 --addr 参数，确认 address 值满足以下任一条件：
立即学习“PHP免费学习笔记（深入）”；
- 是
127.0.0.1（推荐开发/本地使用） - 是
0.0.0.0（监听所有接口，注意防火墙） - 是本机
ip a或ifconfig真实输出的某个 IPv4 地址（如192.168.1.20） - 不是公网 IP（如阿里云 ECS 的 121.x.x.x），除非你手动绑定了该 IP 到网卡
例如，以下配置会触发该错误：
server.address = "121.40.123.45:8080"
因为云服务器通常不会把公网 IP 直接 bind 到 socket，而是靠 SNAT/NAT 转发 —— 你得用 0.0.0.0:8080 或内网 IP。
Linux/macOS 下快速验证 IP 是否可用
别猜，直接查：
- 运行
ip -4 addr show（Linux）或ifconfig | grep "inet "（macOS），看输出里有没有你配置的 IP - 运行
ping -c1 你配置的IP，如果连 ping 都不通，bind()必然失败 - 若用 Docker 或 systemd 启动，还要确认容器网络模式或
BindAddress限制是否干扰了地址解析
注意：localhost 在某些系统（尤其是启用了 IPv6 优先且未配好 hosts 的环境）可能解析为 ::1，而 FrankenPHP 当前默认只支持 IPv4。建议显式写 127.0.0.1 而非 localhost。
Windows 上额外注意 WSL 和 Hyper-V 网络隔离
如果你在 WSL2 中运行 FrankenPHP，并试图绑定到 Windows 主机的 IP（如 192.168.1.100）：
- WSL2 是虚拟机网络，默认无法直接 bind 主机网卡地址
- 必须用
0.0.0.0或127.0.0.1，再通过 Windows 的端口转发（netsh interface portproxy）暴露出去 - 否则会稳定复现
cannot assign requested address
同理，Docker Desktop for Windows 的 LinuxKit VM 也有类似限制 —— 不要尝试在容器内 bind 主机物理网卡地址。
真正容易被忽略的是：这个错误从不提示“你写的 IP 不存在”，它只冷冷抛出一句 cannot assign requested address。查端口、杀进程都没用，得回头盯死配置里的那个 IP 字符串。
