同命名空间下实例化类报错：Class Task not found（无需require()）

问题背景 #

同一目录、同属TestingNamespace命名空间的Task实体类和TaskDAO类，在TaskDAO的mapRowsToDomainObjects方法中执行new Task()时，抛出Class Task not found错误，代码中已添加use TestingNamespace\Task;语句但问题依旧。

排查与解决方法 #

1. 严格检查文件命名规范 #

PHP的自动加载（尤其是PSR-4规范）要求类文件名与类名完全一致（大小写敏感，Linux系统下严格区分）：

• 确保Task类对应的文件名为Task.php，而非task.php、TaskEntity.php等变体
• Windows系统下虽然大小写不敏感，但为了跨环境兼容，建议保持文件名与类名完全匹配

2. 验证自动加载配置是否正确 #

如果使用Composer自动加载：

• 打开composer.json，确认TestingNamespace的目录映射配置正确：

  "autoload": {
      "psr-4": {
          "TestingNamespace\\": "src/your-target-directory/"
      }
  }
  

• 执行composer dump-autoload命令，重新生成自动加载映射文件，确保新类被收录
• 如果是框架自带的自动加载机制，确认框架是否已扫描到该类所在目录，或是否需要手动注册类路径

3. 移除冗余的use语句 #

由于TaskDAO本身已处于TestingNamespace命名空间下，同命名空间的类无需额外use引入，冗余的use TestingNamespace\Task;可能导致自动加载优先级冲突：

• 删除TaskDAO.php中的use TestingNamespace\Task;语句，直接使用new Task()即可

4. 临时手动引入验证（排查自动加载问题） #

在TaskDAO.php开头添加手动引入语句（仅用于测试，不推荐长期使用）：

require_once __DIR__ . '/Task.php';

如果此时错误消失，说明自动加载机制未正确识别Task.php文件，需回到步骤2重新排查自动加载配置。

5. 确认PHP版本支持 #

确保运行环境的PHP版本≥5.3（命名空间特性从PHP5.3开始引入），老旧环境可能存在特性支持缺失问题。

内容的提问来源于stack exchange，提问作者Amruta Ranade