class not found是composer自动加载映射未更新所致；需修改composer.json的psr-4/classmap配置，执行composer dump-autoload或加-o优化，再清理thinkphp与opcache缓存。
如果您在ThinkPHP项目中新增了类文件或修改了composer.json中的autoload配置，但运行时仍提示“Class not found”，则很可能是Composer自动加载映射未同步更新。以下是针对ThinkPHP项目的具体操作步骤：
一、确认并编辑项目根目录的composer.json
ThinkPHP自身不控制自动加载逻辑，所有自动加载规则均由项目根目录下的composer.json定义。必须确保该文件中已正确声明PSR-4映射（如App命名空间指向app/目录），且命名空间末尾带双反斜杠，路径与实际目录结构一致。
1、打开项目根目录下的composer.json文件。
2、在"autoload"字段内添加或检查PSR-4配置，例如："App\": "app/"。
3、若新增了稳定工具类目录（如library/Utils/），可将其加入"classmap"数组以启用扁平映射。
4、保存文件，确保JSON语法合法无误。
二、执行基础dump-autoload命令
该命令强制Composer重新扫描autoload配置所覆盖的所有目录，并刷新vendor/composer/autoload_*.php文件，使新类或路径变更立即生效，不涉及网络请求或依赖变更。
1、在项目根目录下打开终端或命令行工具。
2、执行：composer dump-autoload。
3、观察输出是否显示“Generating autoload files”及完成提示。
4、验证效果：打开vendor/composer/autoload_psr4.php，搜索您的命名空间，确认映射已写入数组。
三、使用优化参数生成classmap映射
在生产环境或类文件数量较多时，启用--optimize可生成autoload_classmap.php，将所有类路径扁平化为键值对，跳过PSR-4的逐层路径拼接与文件存在性判断，显著提升加载速度。
1、确保PSR-4路径下每个PHP文件仅定义一个类，且类名与文件路径严格匹配（如AppControllerHome必须位于app/Controller/Home.php）。
2、执行：composer dump-autoload -o。
3、检查vendor/composer/autoload_classmap.php，确认目标类名已作为数组键出现，值为绝对路径。
4、注意：此模式下新增类后必须重新执行该命令，否则无法识别。
四、排除开发依赖并启用权威类映射
部署至生产环境时，应跳过autoload-dev中声明的测试类路径，并启用--classmap-authoritative，使Autoloader完全依赖classmap，禁用回退到文件系统扫描，进一步减少运行时开销。
1、执行：composer dump-autoload -o --classmap-authoritative --no-dev。
2、确认vendor/composer/autoload_files.php中不再包含dev专用路径。
3、注意：启用--classmap-authoritative后，任何未被classmap覆盖的类将直接报错，不可用于本地频繁增删类的开发场景。
五、结合ThinkPHP缓存机制清理验证
ThinkPHP运行时可能缓存类映射或OPcache未刷新，导致即使autoload文件已更新，仍沿用旧路径。需同步清除框架级与PHP级缓存，确保变更真实生效。
1、删除runtime/cache/与runtime/common/目录下全部内容。
2、执行：php think clear 清除ThinkPHP所有运行时缓存。
3、若服务器启用OPcache，重启Web服务或执行opcache_reset()函数。
4、访问应用接口，验证新类是否可正常实例化且无Class not found报错。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
