CodeIgniter4 v4.1.3 继承FPDF的PdfQuery类无法识别加载报错

• 检查命名空间与文件路径匹配
  CodeIgniter 4 v4.1.3对PSR-4自动加载的校验比早期版本更严格，需确保类文件路径和命名空间完全对应：
  1. 若PdfQuery类放在app/Controllers/PdfQuery.php，命名空间必须声明为namespace App\Controllers;
  2. 若类放在自定义目录（比如app/Libraries），需先在app/Config/Autoload.php的$psr4数组中注册对应映射，示例配置：'App\Libraries' => APPPATH . 'Libraries/'，同时类文件顶部声明对应命名空间
• 检查类调用拼写与引入逻辑
  1. 先核对代码中报错的PdfConsultas类名拼写：你自定义的类名为PdfQuery，如果调用时写错类名必然会触发加载失败
  2. 业务控制器调用PdfQuery前，必须通过use引入对应命名空间的类，示例：use App\Controllers\PdfQuery;，禁止未引入直接写类名调用
• 检查FPDF依赖加载逻辑
  1. 确认app/Config/Constants.php中COMPOSER_VENDOR_DIR配置指向正确的composer vendor目录，默认配置为项目根目录下的vendor文件夹，确保composer自动加载逻辑被正常触发
  2. PdfQuery继承FPDF时需正确引入FPDF的命名空间，示例写法：class PdfQuery extends \FPDF\FPDF，也可提前通过use引入FPDF类后再继承
• 检查文件名大小写匹配
  v4.1.3在Linux环境下严格区分文件名大小写，PdfQuery类对应的文件名必须为PdfQuery.php，禁止使用全小写或者大小写不匹配的文件名，Windows环境下大小写不敏感可正常运行、Linux环境报错的情况优先排查该问题
• 刷新自动加载缓存
  若修改了类文件路径、命名空间后仍加载失败，在项目根目录执行命令composer dump-autoload刷新composer自动加载缓存后再测试

内容的提问来源于stack exchange，提问作者Diego Armando Suarez Echanique