Composer中文镜像主要解决国内访问packagist.org时的链路层与应用层阻塞问题，对TCP连接卡顿、TLS超时、CDN节点MTU不一致及SSL证书验证失败四类故障有明确改善效果。
Composer 中文镜像主要解决的是**国内访问 packagist.org 时的链路层与应用层阻塞问题**，不是万能加速器，但对以下三类典型故障有明确改善效果：
卡在 Resolving dependencies 且 curl -v 停在 TCP connect 阶段
这说明问题出在链路层 MTU 不匹配，而非 DNS 或 HTTPS 层。运营商或中间防火墙会静默丢弃大于 1400 字节的 IP 包（默认 MTU=1500 + TCP/IP 头部=40 → 1540），导致 SYN 包分片失败。
验证方式：ping -s 1472 -M do mirrors.aliyun.com 可通，ping -s 1473 -M do mirrors.aliyun.com 超时，即确认 MTU 问题。
临时修复（Linux/macOS）：sudo ifconfig eth0 mtu 1400；Windows：netsh interface ipv4 set subinterface "以太网" mtu=1400 store=persistent
注意：别设低于 1280，否则影响其他服务；1400 是实测兼容性与性能平衡点。
curl -v 已通但 composer update 报 cURL error 28
底层连接已恢复，但 TLS 握手或首字节响应慢触发了默认 60 秒超时。
必须调高 http.timeout（不是 process-timeout）：composer config -g http.timeout 600
同时检查 PHP 的 default_socket_timeout 是否覆盖该设置：php -i | grep default_socket_timeout，若为 60，则需同步执行：php -d default_socket_timeout=600 $(which composer) update
不建议设为 0——无限等待会掩盖真实链路故障；600 是国内弱网下的安全上限。
换镜像后仍卡在 Downloading 某一个包
这不是镜像源本身问题，而是你本地到不同 CDN 边缘节点的路径 MTU 不一致。阿里云、腾讯云等镜像由多个地域节点组成，有的走直连，有的经受限中转链路，导致部分包可下、部分卡死。
应对策略：
• 立即切备用镜像，如从阿里云切到 https://mirrors.cloud.tencent.com/composer/ 或 https://packagist.proxy.fly.dev
• 用 --repository 参数临时验证，避免污染全局配置：composer update --repository=https://packagist.proxy.fly.dev
• 别依赖单一镜像——高峰时段（如凌晨或大促）阿里云/华为云可能返回 503，而腾讯云和 proxy.fly.dev 更稳定。
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
SSL 证书验证失败或 secure-http false 被拒绝
Composer 2.2+ 默认禁用 HTTP 源，且对证书链校验更严格。错误常源于 PHP 的 OpenSSL 未正确加载系统 CA 证书。
先查路径：php -r "print_r(openssl_get_cert_locations());"，确认 default_cert_file 是否指向有效文件（如 /etc/ssl/certs/ca-certificates.crt）
再更新系统证书包：sudo apt install --reinstall ca-certificates（Debian/Ubuntu）或 brew reinstall ca-certificates（macOS Homebrew）
最后重启 PHP 进程（CLI 下新开终端，Web 下重启 PHP-FPM）
若无法改全局配置，可用：composer config -g repo.packagist.ssl.certificate-authority /etc/ssl/certs/ca-certificates.crt，该配置写入 ~/.composer/auth.json，比环境变量 COMPOSER_CAFILE 更可靠。
真正容易被忽略的点是：**镜像只加速下载，不解决 Resolving dependencies 阶段的卡顿**。如果换源后依然卡在这一步，要立刻排查 PHP 内存限制（COMPOSER_MEMORY_LIMIT=-1）、Xdebug 是否启用（php -d xdebug.mode=off $(which composer) install），以及项目依赖树是否过于复杂——这些和网络无关，但常被误判为“镜像没生效”。
