cms后台在线安装插件卡住、超时或404，90%因未切国内composer镜像或仍直连已停用源；需同步配置全局、项目级repositories及重启php进程，并验证是否真调用composer。
直接上结论：CMS后台在线安装插件卡住、超时、404，90%不是插件本身问题，而是后台调用的 Composer 源没切国内镜像，或根本没走 Composer —— 它可能还在用内置的、已停用的旧包源（如 packagist.phpcomposer.com），甚至硬编码了 https://packagist.org。
为什么CMS后台“在线安装”会连不上包源？
很多 CMS（如 OctoberCMS、TYPO3、PHPCMS 衍生后台）的“在线插件市场”功能，底层其实是封装了一层 composer require 调用。但它不读你本地的全局镜像配置，而是：
- 要么读自己
composer.json里的repositories字段（常为空或写死官方源） - 要么压根没集成 Composer，只是从一个静态 JSON 列表拉 ZIP 包（这时镜像毫无意义，得换源地址）
- 要么调用的是系统级 Composer，但你没配全局镜像，或用了旧版（
packagist.phpcomposer.com已于 2024 年下线）
如何确认后台是否真在用 Composer？
别猜，看日志或临时加调试：
- 打开后台插件安装页，F12 打开 Network 面板，点“在线安装”，观察请求 URL 是否含
/composer/、install、require等路径 - 查 CMS 日志（如
storage/logs/laravel.log或typo3temp/var/log/），搜索composer、exec、shell_exec、proc_open - 在后台执行命令行插件（如有），运行
composer config -g repo.packagist，看返回是不是阿里云地址
如果日志里出现 file_get_contents(): php_network_getaddresses: getaddrinfo failed 或超时，基本可断定它在直连 packagist.org。
三步让后台 Composer 源真正生效
不是改一句配置就完事，必须覆盖三层：
-
改全局 Composer 配置：运行
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/（注意末尾无斜杠） -
改 CMS 项目级配置：进 CMS 根目录，编辑
composer.json，确保repositories字段存在且优先级最高：{ "repositories": [ { "type": "composer", "url": "https://mirrors.aliyun.com/composer/" }, { "packagist.org": false } ] } -
重启 PHP 进程或 FPM 缓存：CMS 后台常驻进程（如 Laravel Octane、Swoole）会缓存 Composer autoloader，不重启，新镜像不会加载；简单做法是
sudo systemctl restart php8.2-fpm或删bootstrap/cache/config.php
插件装上了却“不生效”？检查 autoload 是否重载
OctoberCMS 和 TYPO3 类系统，插件代码装进 vendor/ 后，还需触发类自动加载注册。常见漏掉环节：
- OctoberCMS：装完必须手动跑
php artisan october:up，否则plugins/xxx/vendor/autoload.php不被扫描 - TYPO3：需执行
php typo3cms extension:setup或清空typo3temp/var/cache/code/cache_core - PHPCMS / 迅睿CMS：没有 Composer 集成，所谓“在线安装”只是解压 ZIP，必须点后台“更新缓存”+ 强刷页面（Ctrl+F5），否则模板/路由缓存未刷新
最易忽略的一点：有些 CMS 后台把 Composer 命令包装成异步队列（如通过 Redis 执行），但队列 worker 没起，或权限不对，导致命令根本没执行 —— 此时看队列日志比看插件列表更管用。
