Laravel 5.6执行composer dump-autoload时自定义文件加载失败

看起来你在配置Composer自动加载自定义helper文件时遇到了找不到文件的报错，我之前也踩过类似的坑，咱们一步步来排查解决：

第一步：先确认文件真的在你配置的路径里 #

报错提示找不到app/helpers/dbUsers.php，先打开你的Laravel项目根目录，检查：

• 有没有app/helpers这个文件夹？别不小心写成了app/helper（少了个s）
• 这个文件夹里确实有dbUsers.php和dbMoodChart.php这两个文件吗？有没有拼写错误，比如把dbMoodChart写成dbMoodchart？

第二步：检查文件名的大小写匹配 #

虽然Windows系统的文件路径不区分大小写，但Composer在解析路径时是严格大小写敏感的。比如你在composer.json里写的是dbUsers.php，实际文件如果是DbUsers.php或者dbusers.php，就会导致找不到。一定要保证配置里的文件名和实际文件的大小写完全一致。

第三步：手动验证路径是否可访问 #

在项目根目录打开命令行，执行下面的命令（Windows用type，Linux/Mac用cat）：

# Windows系统
type app/helpers/dbUsers.php

# Linux/Mac系统
cat app/helpers/dbUsers.php

如果能正常显示文件内容，说明路径没问题；如果提示找不到文件，那肯定是路径或者文件名写错了，再仔细核对一遍。

第四步：清除Composer缓存并重新生成自动加载 #

有时候Composer会缓存旧的路径信息，导致新配置不生效。执行以下命令：

composer clear-cache
composer dump-autoload -o

-o参数是优化自动加载，能让加载更高效，开发环境也可以用，试试能不能解决问题。

第五步：检查composer.json的语法是否正确 #

偶尔会因为composer.json里的语法错误（比如多余的逗号）导致配置不生效。执行下面的命令验证：

composer validate

如果有语法问题，命令会提示你修改，修正后再重新dump-autoload。

如果以上方法都不行，你可以试试调整helper文件的存放路径，比如放到app/Support/helpers目录下，然后把composer.json里的files配置改成：

"files" : [
    "app/Support/helpers/dbUsers.php",
    "app/Support/helpers/dbMoodChart.php"
]

有时候路径层级的调整也能解决这种加载问题。

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