FrankenPHP在macOS提示“权限不足”主因是Gatekeeper拦截未公证二进制，需右键“打开”临时豁免、xattr清除quarantine标记或禁用Gatekeeper；同时须确认无同名脚本覆盖、架构匹配、目录写入权限及端口可用。
macOS 安装 FrankenPHP 时提示“权限不足”，通常不是传统意义上的文件权限问题（比如 chmod 不够），而是系统级安全机制在拦截——核心原因是 Gatekeeper 拒绝运行未公证的二进制，或进程用户缺乏对关键路径（如 /tmp、upload_tmp_dir、public/uploads）的实际写入能力。
绕过 Gatekeeper 拦截（解决 Operation not permitted）
FrankenPHP 官方预编译二进制默认未通过 Apple 公证，macOS 10.15+ 会在内核层直接拒绝加载，报错类似 Operation not permitted，此时 chmod +x 完全无效。
-
右键“打开”临时豁免：在 Finder 中右键点击下载的
frankenphp文件 → 选择“打开” → 弹窗点“仍要打开”。该操作仅对该文件生效，后续终端执行./frankenphp也可成功 -
清除 quarantine 标记：终端执行
xattr -d com.apple.quarantine frankenphp（适用于 Safari/Chrome 下载的文件；若用curl或wget获取，需先用open -a Finder .触发标记再清除） -
禁用 Gatekeeper（仅限可信开发机）：运行
sudo spctl --master-disable，然后在「系统设置 → 隐私与安全性 → 安全性」中勾选“任何来源”。注意：生产环境严禁使用
确认二进制真实有效且无冲突
即使绕过 Gatekeeper，以下两类隐藏问题也会导致“权限不足”类表现（如静默退出、Permission denied）：
- 检查是否被同名 shell 脚本覆盖：运行
which frankenphp，再执行file $(which frankenphp)。输出必须含Mach-O 64-bit executable（x86_64 或 arm64）；若显示shell script，说明 PATH 中存在冲突脚本，需删除或重命名 - 验证动态库依赖：用
otool -L frankenphp查看依赖项。若出现not found（如libbpf.dylib），需安装对应库：brew install libbpf；或改用禁用 QUIC 的版本避免此依赖
修复运行时目录写入权限
FrankenPHP 启动后若无法写入临时目录或上传目标目录，会表现为上传失败、缓存生成错误或 500 响应，日志中可能只提示“Unable to move”或静默失败：
立即学习“PHP免费学习笔记（深入）”；
-
临时上传目录（
upload_tmp_dir）：默认用/tmp，但 FrankenPHP 进程用户（如当前 shell 用户）必须有写权限。测试命令：touch /tmp/test-franken.tmp。失败则创建专用目录：sudo mkdir -p /var/tmp/frankenphp-upload && sudo chown $USER:$USER /var/tmp/frankenphp-upload && sudo chmod 755 /var/tmp/frankenphp-upload，并在php.ini中设upload_tmp_dir = "/var/tmp/frankenphp-upload" -
应用上传目录（如
public/uploads）：确保目录存在，且运行用户可写：mkdir -p public/uploads && chmod 755 public/uploads && touch public/uploads/.test && rm public/uploads/.test -
运行时目录（如
storage/、runtime/）：框架常用目录，需同样赋权。可在入口文件开头加初始化逻辑：if (!is_writable('storage')) { @mkdir('storage', 0755, true); @chmod('storage', 0755); }
检查架构匹配与端口占用
两类看似无关但常被误判为“权限问题”的情况：
-
架构不匹配：M1/M2 Mac 必须用
frankenphp-darwin-arm64；Intel Mac 用frankenphp-darwin-amd64。错误架构会报exec format error，现象类似权限失败。确认方式：file frankenphp输出应含arm64或x86_64 -
端口或 socket 冲突：启动时报
address already in use，未必是 TCP 被占——macOS 上dns-sd等 UDP 服务绑定同一端口也可能触发。查全协议：用sudo lsof -iTCP -sTCP:LISTEN -iUDP -sUDP:LISTEN | grep :8000；同时检查残留 socket：ls -l /tmp/frankenphp.sock，存在即删
