composer不支持分片上传，因私有packagist服务端默认仅提供单次zip上传接口；分片容错需由客户端自行实现切片、幂等上传、状态同步及合并校验，服务端须保障幂等性。
Composer 本身不参与“大文件上传”流程，它只负责下载和安装包。所谓“Composer上传至私有Packagist”，实际是 composer publish（非官方命令）或私有仓库管理工具（如 Satis、Private Packagist、Toran Proxy）提供的发布接口，底层仍是 HTTP POST + multipart/form-data 或直接推送 ZIP 包。真正的分片容错不在 Composer 客户端，而在你对接的私有仓库 API 设计里。
私有Packagist上传接口是否支持分片？
绝大多数私有 Packagist 实现（包括官方 Private Packagist、Satis、甚至自建 Laravel + Packagist 镜像）默认只提供单次 ZIP 包上传接口，例如 /api/packages 接收完整 dist ZIP。它们不原生支持分片上传——这不是 Composer 的限制，而是服务端没实现。
- 如果你看到“分片上传”需求，说明你正在对接一个定制化私有仓库，它自己扩展了
/api/chunk和/api/merge接口 - 标准 Packagist 协议（
packages.json+ provider files）只描述元数据，不定义上传协议 - Composer 的
publish命令（如使用composer/packagist-api-client）通常调用的是单次上传 endpoint，失败即重试整包
如何让 Composer 发布流程具备分片容错能力？
关键不是改 Composer，而是绕过它直接控制上传链路。Composer 只管生成 ZIP 和发请求；上传可靠性必须由你封装的客户端保障。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 不要把
zip -r vendor.zip vendor/后直接丢给curl -F "file=@vendor.zip"—— 这是单点故障源 - 先用 PHP 或 Node.js 将 ZIP 文件切片（例如每 5MB 一片），用
fopen($chunkPath, 'r')流式读取，避免内存爆掉 - 每个分片请求带上唯一
file_id和chunk_index，服务端需支持幂等写入：重复传同一片应返回 200 而非报错 - 客户端需维护已成功上传的
chunk_index列表（存在 Redis 或本地 JSON 文件），中断后重新拉取状态再续传 - 合并阶段（
POST /api/merge?file_id=xxx）必须做 SHA256 校验，防止拼接出错
为什么不能依赖 Composer 自带重试机制？
Composer 的 retries 配置（如 "process-timeout": 300）只作用于 HTTP 下载阶段，对上传无意义。它不会帮你拆包、不会跳过已传分片、也不会感知 409 Conflict（分片已存在）这类业务状态码。
-
composer install里的 retry 是针对GET https://repo.example.com/p/provider-laravel~10.0.json失败时重试，不是上传 - 即使你用 Guzzle 构造上传 client，也得手动判断
response->getStatusCode() === 409并跳过该分片，而不是交给'retry_on_status'=> [500, 502] - 超时设置要分开：分片上传建议设
'timeout' => 120，合并请求可设'timeout' => 300，因为合并可能触发解压+索引重建
真正容易被忽略的点是：分片上传的“幂等性”必须由服务端保证，客户端只负责状态同步和并发控制。一旦服务端没做 INSERT IGNORE 或 ON CONFLICT DO NOTHING，重复提交同一分片就会导致数据库冲突或文件覆盖错误——这比网络超时更难排查。
