legacy项目classmap与psr-4混用时，autoload不报class not found的关键是：classmap显式兜底无命名空间或路径错位的legacy类，而psr-4仅处理规范命名空间，二者通过分层配置共存；必须手动在composer.json中声明classmap路径（如"lib/databasehelper.php"），执行composer dump-autoload -o生成静态映射，绕过自动扫描失效问题。
Legacy项目里classmap和PSR-4混用时，autoload怎么不爆Class not found？
直接结论：不能只靠composer.json里的"psr-4"自动映射——Legacy代码往往没按命名空间目录结构存放，Composer会跳过扫描，导致Class not found。必须手动补全映射关系，且优先级要压过自动发现。
常见错误现象是运行composer dump-autoload后，旧类（比如DatabaseHelper）仍无法被new DatabaseHelper()加载，即使它物理路径在lib/下、命名空间却未声明或声明为global。
- Legacy类通常没有
namespace声明，或写在app/但实际归属LegacyUtils - Composer的PSR-4自动映射只检查
namespace声明 + 目录结构匹配，对无命名空间或错位目录直接忽略 - 必须用
"classmap"兜底，且需显式指定路径，不能依赖composer dump-autoload -o自动扫描（它默认跳过无命名空间文件）
如何让Composer同时识别Legacy类和新PSR-4类？
核心是分层配置：classmap负责Legacy，psr-4负责新模块，二者共存不冲突，但加载顺序影响调试效率。
实操建议：在composer.json中明确分离两类路径，避免psr-4根目录覆盖classmap路径（例如别把"src/"和"legacy/"都设为psr-4根）：
{
"autoload": {
"psr-4": {
"App\": "src/",
"Domain\": "domain/"
},
"classmap": [
"legacy/helpers/",
"legacy/models/",
"lib/DatabaseHelper.php"
]
}
}
-
classmap条目支持目录或具体文件，推荐先列具体文件（如lib/DatabaseHelper.php），再逐步扩大到目录 - 执行
composer dump-autoload -o生成优化后的autoload_classmap.php，Legacy类会直接写入映射表，绕过文件系统查找 - 如果Legacy类有
namespace LegacyUtils但目录是legacy/utils/，可改用psr-4映射："Legacy\": "legacy/"，但必须确保所有类文件顶部有对应namespace
中文路径或文件名导致autoload失败怎么办？
Composer本身不拒绝中文路径，但Windows下PHP的opendir()或Linux终端编码不一致时，classmap扫描会漏掉文件，表现为部分Legacy类依然找不到。
根本解法不是禁用中文，而是绕过扫描——手动写死映射：
- 用
composer dump-autoload --no-scripts避免钩子干扰，再检查vendor/composer/autoload_classmap.php是否包含中文路径条目 - 若缺失，在
composer.json的"classmap"里直接写绝对路径（推荐）或相对路径（确保composer.json所在目录为基准）："./legacy/数据库工具.php" - 确认PHP文件保存编码为UTF-8无BOM，否则
include时可能因BOM触发输出，破坏autoloader流程
Legacy类里用了require_once引入其他Legacy文件，autoload还生效吗？
不生效。Composer autoloader只响应new、static::、class_exists()等触发的类加载，对require_once路径不感知——这是最容易被忽略的断裂点。
解决方案只有两个方向：
- 改造Legacy类：删掉
require_once 'xxx.php'，改用new XxxService()或XxxService::method()，让autoloader接管 - 保留
require_once但统一入口：把所有Legacy依赖文件提前require_once进bootstrap.php，再由Composer加载主类（相当于放弃autoloader对依赖链的管理） - 检查
vendor/composer/autoload_files.php，把关键Legacy公共文件（如legacy/functions.php）加进去，它会在autoloader初始化时自动引入
Legacy越深，越容易卡在require_once这一环；与其纠结路径映射，不如先确认哪一行报错——是new找不到类，还是类里require_once失败。两者修复方式完全不同。
