vip go 上 composer install 失败是因为 webroot 只读，必须本地或 ci 构建 vendor 并上传；autoload.php 需用绝对路径如 dirname(abspath) . '/vendor/autoload.php' 加载，且 composer.json 仅保留 name、require、autoload 等必要字段。
为什么 composer install 在 VIP Go 上直接失败？
VIP Go 环境的 webroot（如 /public）是只读文件系统，而 Composer 默认会往 vendor/ 和 composer.lock 写入内容。你执行 composer install 时大概率看到：Permission denied: vendor/autoload.php 或 Failed to write ... read-only file system。这不是权限没开全，是平台设计如此——运行时不可写，必须把依赖构建过程移出运行时。
- 构建阶段必须在本地或 CI 中完成，不是在 VIP Go 服务器上
-
vendor/目录必须作为构建产物整体上传，不能靠线上生成 -
composer install --no-dev --optimize-autoloader是构建命令的标准形态
如何让 autoload.php 正确加载只读 vendor？
VIP Go 的 PHP 自动加载机制本身没问题，但路径错位会导致 require_once 找不到 vendor/autoload.php。常见错误是：本地构建时用的是相对路径 require 'vendor/autoload.php';，而上传后文件结构变了，或者 wp-content/mu-plugins/ 下插件试图从错误位置加载。
- 确保
vendor/autoload.php路径在代码中写死为绝对路径，例如：require_once <strong>DIR</strong> . '/../../vendor/autoload.php'; - 不要用
get_template_directory()或plugin_dir_path()动态拼接，它们可能返回 webroot 下的路径，而vendor/实际在项目根（与wp-content同级） - 检查
WP_CONTENT_DIR和实际目录层级，VIP Go 推荐将vendor/放在站点根目录（即/，和wp-content并列），然后在 mu-plugin 或主题中用dirname(ABSPATH) . '/vendor/autoload.php'
composer.json 中哪些字段在 VIP Go 上容易引发部署失败？
VIP Go 的部署流程会解析 composer.json，但不执行 scripts，也不支持 post-install-cmd 这类钩子。如果你写了：
"scripts": { "post-install-cmd": "chmod -R 755 vendor/" }→ 完全无效，且可能让部署卡住"config": { "vendor-dir": "wp-content/vendor" }→ 危险，wp-content下目录可能被扫描或暴露，且与 VIP Go 的安全策略冲突"minimum-stability": "dev"或大量"repositories"→ 增加构建失败概率，CI 拉包超时或鉴权失败只保留必要字段：
name、require、autoloadautoload推荐用"psr-4"，避免"classmap"导致大体积扫描所有依赖必须是稳定版（
^x.y.z），禁用dev-master或分支别名
如何验证本地构建结果能在 VIP Go 上真正跑通？
光是 composer install 成功、文件传上去不报 500，不代表 autoload 或扩展调用就对了。真实问题常出现在运行时：
- 用
php -l检查所有入口文件语法，特别是 mu-plugin 的主文件 - 在本地模拟只读环境：
chmod -R 555 vendor/ && php -r "require 'vendor/autoload.php';"，看是否 fatal error - 部署后，在 VIP Go 的 debug 模式下访问
wp-admin/admin-ajax.php?action=vip_go_debug_autoload（如有）或手动触发一个依赖服务，观察error_log是否出现Class not found或include(): Failed opening - 注意扩展兼容性：VIP Go 默认启用 OPcache，但某些依赖（如旧版
monolog/monolog）的动态 require 可能被 OPcache 缓存路径，导致类加载失败，此时需加opcache.restrict_api=""（仅限测试）
VIP Go 对 Composer 的约束本质是「构建与运行分离」，不是不让用，而是不允许把构建逻辑塞进运行时。最常被忽略的点是：以为上传了 vendor/ 就万事大吉，却没校验 autoload.php 的加载路径是否真的指向它——路径错一格，整个依赖链就断了。
