本地composer install成功而服务器报错，90%因环境不一致：紧盯php版本（网站设置≠终端默认）、扩展（如gd/pdo_mysql是否真加载）、架构（arm64需验证so文件）、用户权限（root安装vs www运行），并检查镜像配置与网络稳定性。
本地 composer install 成功，服务器报错，90% 是环境不一致导致的，不是代码或配置本身有问题——先别改代码，盯死 PHP 版本、扩展、架构、用户权限这四点。
PHP 版本和 platform 配置冲突
Composer 会检查 platform 配置（比如 "php": "8.2.10"）与当前 PHP CLI 版本是否匹配。本地 PHP 8.2，服务器却是 8.1，composer install 可能静默跳过警告，但运行时一调用 PHP 8.2 新增函数（如 str_starts_with()）就直接 500。
- 在服务器上执行
php -v和php --ini，确认 CLI 使用的 php.ini 路径，再检查该文件里display_errors = On和error_log指向位置 - 如果项目强制要求高版本 PHP，但服务器无法升级，可在
composer.json中临时加"config": {"platform-check": false}，但必须同步检查代码是否真没用到新特性 - 宝塔面板用户注意：网站设置里选的 PHP 版本 ≠ 终端里
php命令默认版本；用which php和/www/server/php/82/bin/php -v分别确认
PHP 扩展缺失或架构不匹配
报错信息像 PHP Fatal error: Uncaught Error: Call to undefined function gd_info() 或 cannot open shared object file: No such file or directory，基本锁定是扩展问题。Composer 不校验扩展是否真能加载，只认名字。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 运行
php -m查看已启用模块，重点核对gd、pdo_mysql、mbstring、openssl等 Laravel / Symfony 常用扩展是否存在 - ARM64 服务器（如 AWS Graviton、部分国产云）上，即使
php -m | grep gd显示有，也可能因为编译时没指定架构，导致ext-gd对应的gd.so文件根本不是 ARM64 架构——用file /path/to/gd.so看输出是否含aarch64 - 扩展存在但未启用？检查对应 php.ini 是否包含
extension=gd.so，且路径正确；有些宝塔安装的扩展路径在/www/server/php/82/lib/php/extensions/no-debug-non-zts-20220829/这类动态目录下
权限和用户上下文导致命令行为不一致
你在宝塔终端里以 root 运行 composer install 成功了，但网站实际由 www 用户运行 PHP，它可能没权限读 vendor/ 下某些文件，或根本找不到 composer.phar。
- 不要在宝塔「文件管理器」里点「终端」后直接
cd /www/wwwroot/example.com && composer install——这个终端常以www用户启动，而composer命令可能只对root可见 - 统一用绝对路径调用：比如
/usr/local/bin/composer install，并确保www用户对/usr/local/bin/composer有执行权（chmod +x）、对项目目录有读写权（chown -R www:www /www/wwwroot/example.com） - 共享主机或权限受限环境，直接用
php composer.phar install，避免依赖全局命令注册
国内网络和镜像配置引发的隐性失败
composer install 表面跑完，但中途因网络超时跳过某些包下载，vendor/ 目录不完整，运行时报 Class not found。这种失败不报错，只在日志里留一句 Failed to download ... Retrying... 后静默继续。
- 服务器上执行
composer config -g repo.packagist，确认是否已切到阿里云镜像：https://mirrors.aliyun.com/composer/ - 加
-vvv参数重跑：composer install -vvv，观察是否有Connection timed out或failed to open stream类错误 - 若仍不稳定，可先在本地
composer install --no-dev生成完整vendor/，压缩上传，避免服务器联网操作
最易被忽略的一点：宝塔计划任务、网站伪静态规则、Nginx 的 fastcgi_param SCRIPT_FILENAME 配置，都可能让 PHP 实际加载的不是你认为的那个入口文件——哪怕 composer install 和 autoload.php 都对，请求一进来就进错脚本，错误日志里却只显示空白 500。
