“class not found”错误主因是自动加载失效、命名空间不匹配或基础扩展（如mbstring/json/xml/openssl）缺失；需依次检查报错详情、验证扩展启用、执行composer dump-autoload -o、清理vendor并声明platform为php 8.2。
PHP 7.1 升级到 8.2 后类找不到，不是文件真丢了，而是自动加载机制失效、命名空间解析失败或扩展缺失导致类定义根本未载入——尤其常见于使用 require_once 手动引入却路径错误、Composer autoloader 未重生成、或 mbstring/json/xml 等基础扩展未启用的场景。
确认类未加载的真实原因
第一步：在报错页面顶部临时插入代码：error_reporting(E_ALL); ini_set('display_errors', '1');，再刷新，看是否出现 Fatal error: Uncaught Error: Class "xxx" not found 或更底层的 require(): Failed opening required。
第二步：执行 php -m | grep -E "(mbstring|json|xml|curl|openssl)"，确认这些 PHP 8.2 必需的基础扩展全部在列表中。缺任意一个，composer autoload 都可能静默失败。
第三步：运行 composer dump-autoload -o 强制重建优化后的自动加载映射。PHP 8.2 对 PSR-4 的路径解析更严格，旧缓存中残留的 7.1 时代映射条目会直接跳过类文件扫描。
修复 Composer 自动加载失效
方法一：清空并重生成 vendor 目录
删除项目根目录下的 vendor/ 和 composer.lock；运行 composer install --no-dev（生产环境）或 composer update --with-all-dependencies（开发环境）。这一步强制所有依赖按 PHP 8.2 兼容版本重新解析和安装，【旧 lock 文件中的 PHP 7.1 约束会阻止高版本包安装，必须删】。
方法二：检查 composer.json 中的 platform 配置
打开 composer.json，确认 "config": {"platform": {"php": "8.2.12"}} 已显式声明。若缺失或仍写为 "php": "7.1"，Composer 会模拟 7.1 环境安装低版本包，导致类名变更（如 Doctrine\Common\Inflector\Inflector 在新版本中已移至 Doctrine\Inflector\Inflector）无法被识别。
定位并修正 require/include 路径错误
第一步：在报错的 require_once 'xxx.php' 上方加一行：var_dump(__DIR__, getcwd(), file_exists(__DIR__ . '/xxx.php'));
第二步：对比输出——如果 __DIR__ 是 /var/www/app，但 getcwd() 是 /var/www，而文件实际在 /var/www/app/xxx.php，说明你用了相对路径 require_once 'app/xxx.php' 却误以为从脚本所在目录解析；正确写法是 require_once __DIR__ . '/xxx.php';。
第三步：检查 php.ini 中 include_path 是否被清空或覆盖。PHP 8.2 默认 include_path=".;/usr/share/php"（Windows）或 include_path=".:/usr/share/php"（Linux），若被设为 include_path=""，所有无绝对路径的 require 都会失败。
验证核心扩展是否真正启用
运行 php -i | grep -A5 "Registered PHP Streams"，确认输出包含 https, http, php, file, data, compress.zlib —— 缺 https 流意味着 openssl 扩展未启用，Composer 下载包时会中断，vendor/autoload.php 根本生成不全。
若发现 openssl 缺失：CentOS/RHEL 执行 dnf install php82-php-openssl（remi 仓库），Windows 用户检查 php.ini 中 extension=openssl 是否取消注释，且 php_openssl.dll 文件存在于 extension_dir 指向的目录中。
这一步操作起来很简单，直接把文件拖进去就行。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
