Drupal项目Composer Install遇asset-packagist.org间歇性404错误求助

数据老陈

2026-6-22

解决Drupal项目中asset-packagist间歇性Composer 404错误的思路

清除Composer本地缓存
缓存的CDN资源路径可能已失效，执行以下命令清空缓存后重新安装：
```
composer clear-cache
composer install
```
本地缓存的provider文件如果是旧版本，会指向已被CDN移除的资源，导致间歇性404。
修正asset-packagist仓库配置类型
将原composer类型改为asset-packagist专用类型，让Composer正确适配asset-packagist的资源结构：
修改composer.json中的repositories部分：
```
"repositories": [
    {
        "type": "composer",
        "url": "https://packages.drupal.org/8"
    },
    {
        "type": "asset-packagist",
        "url": "https://asset-packagist.org"
    }
]
```
专用类型会让Composer使用asset-packagist的专属处理逻辑，减少CDN路径解析错误。
强制使用HTTP/1.1协议
部分CDN节点对HTTP/2的支持不稳定，可强制Composer用HTTP/1.1请求：
临时执行命令：
```
composer install -- --with-curl-option=CURLOPT_HTTP_VERSION=CURL_HTTP_VERSION_1_1
```
或永久配置到composer.json：
```
"config": {
    "curl.options": {
        "CURLOPT_HTTP_VERSION": 1
    }
}
```
启用Composer重试机制
针对间歇性网络/CDN故障，让Composer自动重试请求：
```
composer install --retry=3
```
指定重试次数，跳过临时的404错误。
确认asset-packagist服务状态
检查asset-packagist官方是否有临时服务中断或维护，排除上游服务问题。