frankenphp上传大文件拖慢普通接口，主因是共享线程池与临时目录导致资源争抢；须通过独立worker隔离上传路径、强制分片、重定向upload_tmp_dir至高速磁盘并显式ini_set覆盖。
FrankenPHP上传大文件时，普通接口变慢不是因为“PHP跑得慢”，而是大文件上传占满线程、阻塞I/O、挤占内存资源导致的连锁反应。关键不是压低上传速度，而是隔离上传路径、限制资源占用、避免污染主线程池。
为什么上传大文件会拖慢其他接口
FrankenPHP默认用同一组PHP线程处理所有请求（包括上传和普通API）。一个2GB文件分片上传持续几十秒，每个分片请求都会独占一个线程；如果并发上传多路，线程池迅速被占满，后续的登录、查询等轻量请求只能排队等待——这不是超时，是排队超时。
更隐蔽的问题是：FrankenPHP默认max_memory_upload极小（约2MB），超过后自动落盘，但落盘路径若在高IO磁盘或容器tmpfs里，写入竞争会进一步拖慢整个Go runtime的调度效率。
- 现象：上传进行中，
/api/user/profile响应延迟从50ms飙升到1.2s，ps aux | grep frankenphp显示大量worker进程处于D（uninterruptible sleep）状态 - 根本原因：上传请求与普通请求共享同一套
num_threads和同一套临时文件系统路径 - 验证方式：用
pidstat -d 1观察frankenphp进程的IO/s峰值，上传时若持续>10MB/s且普通接口延迟同步上升，基本可锁定I/O争抢
用独立Worker隔离上传入口
FrankenPHP支持为特定路径配置专用Worker，让上传走独立线程池，完全不干扰主服务。这是最直接有效的解法。
在Caddyfile中添加独立上传Worker区块：
frankenphp {
# 主应用（普通接口）
php_server /path/to/app/public
<pre class="brush:php;toolbar:false;"># 专用上传Worker，不参与主路由
worker {
file /path/to/app/public/upload_worker.php
num 4
env UPLOAD_TMP_DIR /mnt/fast-ssd/uploads/
}}
-
num 4：上传专用线程数，设为CPU核心数的1/2～1/3即可，避免过度抢占 -
env UPLOAD_TMP_DIR：强制指定高速磁盘路径，绕过默认内存缓冲阈值，也避免/tmp目录inode耗尽 - 前端上传请求必须发往
/frankenphp-worker（FrankenPHP自动挂载的Worker入口路径），不能走/api/upload这种主路由
前端必须携带分片元信息，后端拒绝整文件上传
即使做了Worker隔离，如果前端仍用<input type="file">直传整个文件，FrankenPHP依然会先尝试内存缓冲，触发max_memory_upload限制后才落盘——这个缓冲过程本身就会卡住Worker线程几秒。
必须强制前端分片，并在每个请求中显式传递以下字段：
-
file_id：UUID，标识本次上传会话 -
chunk_index：当前分片序号（从0开始） -
total_chunks：总分片数 -
chunk_size：单片字节数（如5242880） - 禁用
enctype="multipart/form-data"整文件表单，全部改用fetch()+FormData.append('chunk', blob)
后端upload_worker.php第一行就该校验：
if (!isset($_POST['file_id'], $_POST['chunk_index'], $_FILES['chunk'])) {
http_response_code(400);
exit('missing required fields');
}
这样能立刻拦截非法请求，避免无效缓冲开销。
上传临时目录必须挂载到独立磁盘或设置noatime
FrankenPHP Worker落盘时，默认用sys_get_temp_dir()，通常指向/tmp。而/tmp在很多Linux发行版中是tmpfs（内存文件系统），一旦上传量大，会吃光RAM并触发swap，全局性能雪崩。
- 查当前路径：
php -r "echo sys_get_temp_dir();" - 生产环境必须通过
env TMPDIR=/mnt/fast-ssd/tmp重定向，且确保该路径所在分区启用了noatime（减少inode更新开销） - 验证是否生效：
mount | grep "$(df . | tail -1 | awk '{print $1}')" | grep noatime - 额外加固：在
upload_worker.php开头加ini_set('upload_tmp_dir', $_SERVER['UPLOAD_TMP_DIR'] ?? '/mnt/fast-ssd/tmp');，双重保险
最容易被忽略的是：FrankenPHP的Worker模式下，upload_tmp_dir不会自动继承Caddyfile里的env，必须在PHP脚本里显式调用ini_set覆盖，否则仍走默认/tmp。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
