bind: permission denied 表示权限不足，仅限特权端口（如 :80/:443），非 root/Admin 用户默认无权绑定；address already in use 表示端口已被其他进程占用，任何端口均可能发生，需用 netstat 或 lsof 定位并终止冲突进程。
报错信息直接区分：listen tcp :80: bind: permission denied ≠ address already in use
FrankenPHP 启动失败时，bind: permission denied 和 address already in use 是两类完全不同的问题，不能混为一谈。前者是操作系统拒绝授权（权限不足），后者是端口已被其他进程绑定（占用）。Windows/macOS/Linux 表现一致，但触发条件和解决路径完全不同。
-
bind: permission denied：只发生在特权端口（:1–:1023），比如:80、:443；非 root/Admin 用户默认无权监听 -
address already in use：任何端口都可能出现，只要已有进程调用bind()成功（无论是否在监听） - macOS 上还可能看到
bind: Can't assign requested address，多因 IPv6 配置或 localhost 解析异常，不是权限也不是占用
Windows 下怎么确认是 PID=4 还是真没权限
Windows 默认禁止普通用户绑定 :80/:443，但系统级 HTTP.sys（PID=4）又常“伪装”成权限问题。必须用管理员 CMD 查清本质：
- 运行
netstat -ano | findstr :80，若末尾 PID 是4→ 是 HTTP.sys 占用，不是权限问题；禁用W3SVC、Web Deployment Agent Service等服务即可 - 若输出为空，但启动仍报
permission denied→ 确实是权限不足：要么改用非特权端口（如--addr :8080），要么以管理员身份运行命令 - 别信“以管理员身份运行”就能解决所有
:80问题——如果 PID=4 已在监听，你再提权也 bind 不上，必须先停服务
macOS/Linux 怎么快速验证是权限还是占用
Linux/macOS 权限模型更清晰，但容易忽略用户组或 capability 限制。优先用 lsof + id 组合判断：
- 查端口：
lsof -i :80，有输出且 COMMAND 不是frankenphp→ 占用；无输出但报permission denied→ 权限问题 - 确认当前用户是否有权绑定：
id -u不是0，且未用setcap 'cap_net_bind_service=+ep' ./frankenphp赋权 → 普通用户无法监听:80 - macOS 特例：即使你是 root，
sudo lsof -i :80仍可能看不到 ControlCenter 占的:7000，得加-sTCP:LISTEN或换sudo lsof -nP -iTCP:7000 -sTCP:LISTEN
一个命令排除法：curl + fsockopen 辅助定位
终端报错有时含糊，尤其 Docker 或 systemd 环境下 stderr 被截断。可用 PHP 自身能力交叉验证：
立即学习“PHP免费学习笔记（深入）”；
- 写个临时脚本跑
fsockopen('127.0.0.1', 80, $errno, $errstr, 1)：若$errno === 13（Permission denied）→ 权限问题；$errno === 98（Address already in use）→ 占用 - 用
curl -v http://localhost:80测试：连接被拒绝（Failed to connect）→ 很可能根本没进程在 listen；Connection refused 与 Connection timed out 的语义不同，前者是端口空闲但没人接，后者才可能是防火墙或路由问题 - 注意：FrankenPHP 启动失败时，
curl通常收不到响应；但若 curl 能连上却返回 502/503，说明 FrankenPHP 起来了，只是后端 PHP 处理出错——这已不属于端口权限范畴
真正容易被忽略的是：Windows 上 PID=4 不是“权限不够”，而是“它本来就有权”，你争不过；Linux 上给二进制加 cap_net_bind_service 后，普通用户就能绑 :80，但这个 capability 不会自动继承到子进程（比如通过 exec() 调起的 PHP 脚本），所以 FrankenPHP 主进程能 bind，不代表它 spawn 的 worker 就能——这点文档极少提及。
