FrankenPHP环境下上传失败首要排查open_basedir是否包含upload_tmp_dir路径：需确认该路径存在、可写、属主正确，且在open_basedir白名单中完整匹配（末尾斜杠不可缺、分隔符须为英文冒号或分号）。
先查 PHP 临时目录是否在 open_basedir 白名单内，且该目录存在、可写。 这是 FrankenPHP 环境下最常被忽略的硬性拦截点——不是权限没给够，而是路径直接被 PHP 安全机制拒绝访问。
为什么 open_basedir 是 FrankenPHP 上传失败的第一怀疑对象
FrankenPHP 默认启用严格沙箱行为，open_basedir 限制比传统 FPM 更激进。一旦你手动设了 upload_tmp_dir（比如指向 E:/tmp），但 open_basedir 只放行了 C:/wwwroot/;C:/Windows/Temp/，PHP 就会在创建临时文件时直接报错并崩溃，Nginx 返回 500，日志里只显示“无法创建临时文件”或“open_basedir restriction in effect”。
这种错误不抛出明确异常，也不进 WordPress 错误钩子，所以你在后台只看到“服务器无法处理该图像”，完全摸不着头脑。
- 用
phpinfo()或ini_get('open_basedir')确认当前生效值 - 用
sys_get_temp_dir()和ini_get('upload_tmp_dir')看 PHP 实际要用哪个路径 - 检查该路径是否：存在、属主为 FrankenPHP worker 用户（如
www-data）、权限为755、且完整包含在open_basedir字符串中（注意末尾斜杠和分号分隔）
upload_tmp_dir 路径必须同时满足三个条件
它不能只是“能写”，还必须是 FrankenPHP 进程能“看见”的合法路径：
立即学习“PHP免费学习笔记（深入）”；
将 LaTeX（.tex）学术论文转换为 Word（.docx），支持可编辑的 OMML 公式、原生 Word 表格、嵌入图形、IEEE 双栏排版及参考文献
- 路径必须是绝对路径（
C:/BtSoft/php/84/tmp，不是./tmp或tmp） - 路径必须落在
open_basedir列表中的某一项之内（例如C:/BtSoft/php/84/tmp必须被C:/BtSoft/php/84/或更宽泛的C:/包含） - 目录必须已存在，且 FrankenPHP worker 进程用户有
rwx权限（Windows 下重点检查 ACL，Linux 下用ls -ld看属主）
常见翻车点：upload_tmp_dir = "C:/wwwroot/mysite/tmp"，但 open_basedir = "C:/wwwroot/mysite/" —— 注意末尾斜杠缺失导致匹配失败；或路径用了反斜杠但 ini 解析出错，建议统一用正斜杠。
别跳过 $_FILES['error'] 的原始值
WordPress 封装层会吞掉底层错误，直接读 $_FILES['file']['error'] 才能定位真实原因：
-
UPLOAD_ERR_NO_FILE (4)：表单没选文件（前端问题） -
UPLOAD_ERR_CANT_WRITE (7)：目标目录不可写（wp-content/uploads权限问题） -
UPLOAD_ERR_EXTENSION (8)：被扩展模块拦截（如open_basedir或disable_functions中禁用了move_uploaded_file） -
UPLOAD_ERR_PARTIAL (3)或UPLOAD_ERR_FORM_SIZE (2)：说明请求根本没进 PHP，卡在 Nginx 或 FrankenPHP 的 body 大小限制上（查client_max_body_size和post_max_size）
FrankenPHP 的 post_max_size 默认可能比传统 PHP 更保守，尤其在使用 frankenphp.yaml 配置时，需显式设置 php_values: { post_max_size: 64M }。
真正麻烦的从来不是“找不到错”，而是错被层层封装后只剩一个模糊提示。FrankenPHP 的安全默认值让 open_basedir 和 upload_tmp_dir 的对齐成了第一道窄门——跨不过去，后面所有权限、插件、内存调优都白搭。
