Laravel项目部署至本地Laragon后指向错误路径，如何解决？

1. 清除全量缓存文件 #

仅执行config:clear和dump-autoload可能不够，需清除所有缓存类型，确保旧路径缓存被彻底清理：

• 依次执行以下命令：

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

• Laravel 8及以上版本可直接执行一键清除命令：

  php artisan optimize:clear
  

2. 修正.env文件路径配置 #

检查项目根目录的.env文件，替换所有线上路径为本地路径：

• 将APP_URL改为本地访问地址，比如http://your-project.test（Laragon默认的.test域名格式）
• 若存在自定义路径配置（如STORAGE_PATH、LOG_PATH），同步替换为本地Laragon项目的对应路径
• 核对文件存储相关配置，比如FILESYSTEM_DISK对应的磁盘根路径，确保指向本地目录

3. 检查config目录硬编码路径 #

打开config/filesystems.php，确认各个磁盘的root配置无硬编码的线上路径；同时排查config/app.php等其他配置文件，替换所有遗留的线上路径为本地路径。

4. 重建存储软链接 #

若项目使用了public/storage软链接，线上的链接路径在本地无效，需重新生成：

php artisan storage:link

5. 替换数据库中的旧路径数据 #

如果数据库中存储了文件路径（如附件、图片的绝对路径），需批量替换为本地路径：

• 执行SQL语句（替换对应的表名和字段名）：

  UPDATE your_table SET file_column = REPLACE(file_column, '/线上旧路径', '/本地新路径');
  

6. 清理Composer缓存 #

执行以下命令清除Composer缓存并重新生成自动加载文件：

composer clear-cache
composer dump-autoload -o

7. 核对Laragon环境配置 #

• 确保Laragon的PHP版本与线上服务器一致，避免版本差异导致路径解析异常
• 确认Laragon站点指向的是项目的public目录，保证入口路径正确

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