Laravel中unisharp/filemanager与CKEditor文件/图片上传浏览报404错误求助

我来帮你排查这个404问题，结合你已经完成的操作，咱们一步步梳理可能的原因和对应的解决办法：

1. 确认路由是否正确注册 #

首先要确保FileManager的路由已经被加载到你的Laravel项目中：

• 运行命令 php artisan route:list，在输出结果里搜索包含 laravel-filemanager 的路由。如果完全找不到相关路由，说明服务提供者没注册：
  • 打开 config/app.php，检查 providers 数组里是否包含以下两行：

    UniSharp\LaravelFilemanager\LaravelFilemanagerServiceProvider::class,
    UniSharp\Ckeditor\ServiceProvider::class,
    

  • 如果没加，添加上之后重新运行 php artisan route:clear 刷新路由缓存。

2. 核对FileManager配置与URL路径 #

• 打开 config/lfm.php，检查 'prefix' => 'laravel-filemanager' 这个配置项，确保它和你视图代码里拼接的URL前缀完全一致。如果你修改过这个前缀，视图里的路径也要同步更新。
• 你已经添加了 'middlewares' => ['web', 'auth']，要确保当前操作的用户处于登录状态（否则会被auth中间件拦截，可能表现为404或者跳转登录页）。如果测试阶段不需要认证，可以暂时改成 ['web'] 来排查问题。

3. 检查存储链接与目录权限 #

FileManager默认使用Laravel的storage目录，这一步很容易被忽略：

• 运行命令 php artisan storage:link，建立public目录到storage/app/public的软链接。如果没有这个链接，上传的文件无法被公开访问，也可能间接导致路由层面的异常。
• 检查服务器上的 storage/app/public 和 public/laravel-filemanager 目录权限，确保服务器进程（比如www-data）有读写权限，一般设置为755或者775即可。

4. 优化视图中的URL生成逻辑 #

你手动拼接URL的方式容易出错，建议改用Laravel的route()助手函数自动生成正确的路由地址，避免路径拼接错误：
修改你的JS配置为：

var options = {
    filebrowserImageBrowseUrl: "{{ route('lfm.show', ['type' => 'Images']) }}",
    filebrowserImageUploadUrl: "{{ route('lfm.upload', ['type' => 'Images']) }}?_token={{ csrf_token() }}",
    filebrowserBrowseUrl: "{{ route('lfm.show', ['type' => 'Files']) }}",
    filebrowserUploadUrl: "{{ route('lfm.upload', ['type' => 'Files']) }}?_token={{ csrf_token() }}"
};

这样可以确保URL是根据路由名称自动生成的，不会因为APP_URL配置错误或者手动拼写失误导致404。

5. 重新发布资源并清空缓存 #

有时候资源发布不完整会导致静态文件或配置缺失，重新执行以下命令：

php artisan vendor:publish --tag=ckeditor
php artisan vendor:publish --tag=lfm_config
php artisan vendor:publish --tag=lfm_public

然后彻底清空缓存：

php artisan route:clear
php artisan config:clear
php artisan cache:clear

6. 检查.env中的APP_URL配置 #

打开项目根目录的.env文件，确认APP_URL的值是你的项目实际访问地址（比如APP_URL=http://your-local-domain.test）。Laravel生成绝对URL时依赖这个配置，如果配置错误，拼接出来的FileManager地址自然会无效。

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