基于磁盘AIO（异步IO）提升Composer镜像索引的并发读取

Composer镜像小文件随机读不适用aio on，必须用aio threads线程池解耦：需全局定义thread_pool、location中sendfile off、aio threads=指定池名，三者缺一不可。

Composer 镜像索引（像 packages.json、provider-*.json 这类文件）本质上就是大量小文件的随机读取。如果直接套用 Linux 原生 AIO（也就是 aio on），不仅白费力气，还会因为强制开启 directio 而导致性能大幅下滑。真正能走通的路是：利用 Nginx 的 aio threads 线程池，把磁盘读操作从事件循环里剥离开，同时避开页缓存竞争和小文件对齐这些雷区。

为什么 aio on 对 Composer 镜像完全不适用

先看一组现实数据：Composer 镜像返回的 JSON 文件普遍只有 10KB～500KB，而 aio on 的启用前提却相当苛刻——必须靠 directio 触发 O_DIRECT、文件系统要对齐、内核 ≥ 4.18，而且只对 1MB 以上文件有效。实际压测下来，开启 aio on 后，strace -e trace=io_submit 几乎看不到任何调用，error_log 里却刷出一堆 "aio_read() failed: Invalid argument"。这不是配置写错了，是机制本身就不匹配。

• aio on 是为视频、ISO 这类大文件顺序读设计的，跟高并发小文件随机读根本不是一回事
• Composer 的 packages.json 通常被 open_file_cache 高频命中，磁盘读本来就极少，开 AIO 几乎没有感知
• directio 一绕过页缓存，小文件反复读就会彻底失去缓存加速，IOPS 反而下降 30% 以上

正确启用 aio threads 的三步硬要求

线程池模式的好处是不依赖 directio 或文件对齐，它直接把 read() 系统调用扔进独立线程执行，worker 进程不会阻塞。但想用起来，三个条件必须同时满足，少一个都不行：

• 全局定义线程池：thread_pool composer_pool threads=64 max_queue=32768;（SSD 环境下，64 个线程足够应对 5K 以上的并发请求）
• 在 location 中关闭 sendfile：sendfile off;（否则 Nginx 会直接走零拷贝路径，绕过线程池）
• 明确启用线程池读：aio threads=composer_pool;（绝对不能写成 aio on，两者互斥）

一个典型的配置片段长这样：

thread_pool composer_pool threads=64 max_queue=32768;
server {
    listen 80;
    root /var/www/composer-mirror;
location / {
    # 关键：禁用 sendfile，否则 aio threads 不生效
    sendfile off;
    # 关键：指定线程池，非 "on"
    aio threads=composer_pool;
    # 可选但推荐：提升单次 read 缓冲
    output_buffers 2 256k;
}
}
容易被忽略的两个性能断点
即使配置全对了，仍然可能被两个地方卡住，导致并发上不去或者延迟出现严重毛刺：

open_file_cache 没有启用，或者参数设置得过激：Composer 请求的重复度很高，比如反复查 lara vel/framework，这时候应该设置 open_file_cache max=10000 inactive=30s;，否则每次都要 stat()+open()，线程池再快也救不了 syscall 的开销
回调逻辑仍然在 worker 中执行：如果你在 log_format 里用了 $request_time，或者用自定义 Lua 脚本解析 JSON，这些操作还是在 worker 线程里跑——线程池只负责读文件，后续的 CPU 密集型动作必须单独剥离出去

判断配置是否真正生效，不是看 nginx -t 通过，而是用 ab -n 10000 -c 1000 http://mirror/packs/lara vel/framework.json 压测时，top 命令里 nginx: worker process 的 CPU 占用稳定在 30%～50%，而 nginx: cache manager process 和 nginx: thread pool 各自占 20% 左右——这说明 I/O 已经成功卸载到独立线程，没有卡住事件循环。