Composer 是微信小程序 PHP 后台的必需依赖管理工具，name 字段必须为小写 vendor/name 格式，PSR-4 映射路径须以斜杠结尾，生产环境仅用 composer install，且需严格匹配 PHP 版本与 SDK 兼容性。
微信小程序后台用 PHP 写接口时，Composer 不是“可选配件”，而是必须靠它加载 SDK、HTTP 客户端、数据库驱动等核心依赖；不规范使用会导致本地能跑、线上 Class not found 或 token 解析失败。
composer.json 的 name 字段填错就直接 autoload 失效
小程序后台常要调用微信开放平台 API，比如用 wechat/wechat 或 overtrue/wechat SDK。但只要 composer.json 里 name 字段写成 "MyApp"、"wechat-api" 或 "WECHAT/Backend"，哪怕只错一个大写字母或漏 vendor，Composer 就不会把你的 src/ 目录纳入自动加载范围。
结果就是：new WeChatServer() 报 Class 'WeChatServer' not found，而错误堆栈根本不提 name 字段——它只在解析 autoload 阶段静默跳过。
-
name必须是全小写 + 单斜杠 + vendor/name 格式，例如"local/wechat-backend"或"acme/miniprogram-api" - vendor 名不用和 GitHub 一致，但绝不能为空、不能是
"wechat"（单段）或"MiniProgram"（含大写） - 改完
name后，必须手动运行composer dump-autoload，install或update不会触发重生成
PSR-4 映射末尾缺斜杠，类文件永远找不到
小程序后台通常把控制器放在 src/Controller/，命名空间设为 AppController。如果 composer.json 里写成：
立即学习“PHP免费学习笔记（深入）”；
"autoload": {
"psr-4": {
"App\": "src/App"
}
}
那 new AppControllerLoginController() 会尝试加载 src/AppController/LoginController.php（注意中间没分隔符），而不是你期望的 src/Controller/LoginController.php。
- PSR-4 的映射值必须以斜杠结尾：
"App\": "src/"或"App\": "src/Controller/" - 路径是相对于
composer.json所在目录的，不要加./，也不要用绝对路径 - 目录本身必须真实存在，Composer 不校验，直到运行时才报错
生产环境必须用 composer install，别碰 update
小程序上线后，接口稳定性压倒一切。CI/CD 流水线或服务器部署脚本里如果写了 composer update，哪怕只是更新一个 dev-only 包，也可能连带升级 guzzlehttp/guzzle 到新主版本，导致微信 POST /cgi-bin/token 返回格式变化、json_decode 失败。
- 线上部署只允许执行
composer install --no-dev --optimize-autoloader -
composer.lock必须提交到 Git，且和本地开发环境完全一致 - 本地改了依赖后，先
composer update xxx/xxx，再git add composer.json composer.lock，最后推送到线上 - 切勿手动编辑
composer.lock，哪怕只是改个 hash——用composer update --lock替代
微信 SDK 依赖的 PHP 版本约束容易被忽略
很多微信 SDK（如 overtrue/wechat v6.x）要求 PHP >= 8.0，但小程序后台可能还跑在 PHP 7.4 上。此时 composer require overtrue/wechat 表面成功，实际安装的是 v5.x 兼容版，而 v5.x 不支持微信最新消息加解密协议（比如 AES-256-CBC），导致接收不到用户消息。
- 装包前先查目标 SDK 的
composer.json，看它的require.php字段 - 明确指定兼容版本：
composer require overtrue/wechat:^5.2（若必须用 PHP 7.4） - PHP 8.5.5 已发布，但微信 SDK 对 8.5 的适配仍不统一，建议锁定
php: ^8.1并测试 token 获取、消息解密、模板消息发送三处关键链路
最常被跳过的一步：改完 autoload 或 name 后，忘了删掉 vendor/autoload.php 重新生成——它不会自动刷新，旧文件里根本没你新加的命名空间映射。
