Composer install成功不等于项目能运行，常见问题包括autoload未正确引入、PHP版本或扩展不匹配、autoload文件未更新、PSR-4映射错误、runtime目录（如storage/）权限不足、环境变量或配置未生效等。
执行 composer install 成功，不代表项目能跑起来——它只保证 vendor 目录和依赖文件被拉下来、composer.lock 被读取并校验通过。真正报错，往往出在环境适配、权限、autoload 或配置加载环节。
vendor/autoload.php 没被正确引入
这是最常被忽略的「成功假象」：命令没报错，但 PHP 脚本压根没加载自动加载器，导致 Class not found。
- 检查入口文件（如
index.php或public/index.php）是否第一行就写了require __DIR__.'/../vendor/autoload.php'; - 路径写错很常见：
../vendor/autoload.php在某些部署结构下会变成../../vendor/autoload.php，建议用__DIR__ . '/vendor/autoload.php'并确认 vendor 确实在当前目录同级 - 运行
php -m | grep -i json或php -v验证 PHP 版本和扩展是否满足composer.json中config.platform.php或require.php的约束；不匹配时 autoload 生成可能跳过部分 namespace
autoload 生成失败或未更新
composer install 不会强制重生成 autoload 文件，除非检测到变更。旧的 vendor/composer/autoload_*.php 可能残留错误映射。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 手动触发重建：
composer dump-autoload --optimize（生产环境推荐）或composer dump-autoload -o - 如果用了 PSR-4 映射但类文件名/命名空间不一致（比如
App\Controllers\Home对应app/Controllers/home.php），autoload 就不会注册该类——注意大小写和文件后缀 - 检查
composer.json中"autoload"和"autoload-dev"是否包含你实际用到的路径；开发时加了新类但忘了dump-autoload，就会漏掉
权限问题导致 runtime 目录不可写
composer install 成功，但框架启动时报 failed to open stream: Permission denied，通常不是 vendor 权限，而是 storage/、var/cache/、bootstrap/cache/ 这类运行时目录没写权限。
- 确认报错路径（比如 Laravel 报
storage/logs/laravel.log），然后执行：ls -ld storage logs/查看所有者和权限 - 修复命令示例（以 Laravel 为例）：
sudo chown -R $USER:www-data storage bootstrap/cache+chmod -R 775 storage bootstrap/cache - 若曾用
sudo composer install，vendor 下文件可能属 root，后续 PHP-FPM 以 www-data 用户运行时无法读取——必须sudo chown -R $USER:www-data vendor/
环境变量或配置未生效
composer install 不处理 .env、config/ 或缓存配置文件，这些全靠框架自己加载。安装成功但报 DB 连接失败、密钥缺失等，基本是这层断了。
- 检查
.env是否存在且格式正确（APP_KEY=后不能有空格，DB_PASSWORD=xxx中若含#或:必须加引号） - Laravel 用户注意：
php artisan config:clear和php artisan cache:clear必须在.env改完后执行，否则 config 缓存仍是旧值 - Symfony 用户检查
config/packages/*.yaml中是否引用了未安装的 bundle，或参数里用了未定义的 env var（如%env(APP_SECRET)%但 .env 里没设）
真正卡住的点，往往不在依赖安装本身，而在 autoload 加载、runtime 目录权限、环境配置三者的衔接处。每次报错，先盯住错误堆栈第一行的真实路径和类名，再逆推是哪个环节没对上——而不是重跑 composer install。
