Laravel 5.4 整合WordPress迁移新服务器后部分路由出现fatal error

排查解决步骤 #

1. 修复首页Call to a member function route() on string报错 #

该报错核心原因是Laravel收集路由中间件时，获取到的路由实例为字符串而非预期的路由对象，按以下顺序排查：

• 检查app/Http/Kernel.php中的路由中间件注册逻辑：
  找到文件内的$routeMiddleware数组，确认路由中用到的auth.donor、guest、profile等中间件都有正确注册，值必须为合法的中间件类路径（例：'auth.donor' => \App\Http\Middleware\AuthenticateDonor::class），漏注册、类名拼写错误都会触发该报错，修正后重启服务测试。
• 核对PHP版本与Laravel版本兼容性：
  若旧服务器PHP版本低于8.0，新服务器使用PHP8.1+且Laravel版本低于8.0，会出现中间件参数解析异常，可先将新服务器PHP版本降级到与旧服务器一致，确认是否解决问题。
• 确认public/index.php为原整合版本：
  该项目是Laravel+WordPress整合架构，原public/index.php一定有定制的整合逻辑，不要使用默认的Laravel或WordPress入口文件，从旧服务器备份中拉取原入口文件覆盖当前文件，避免Laravel生命周期执行异常。

2. 修复/donor、/parent路由重定向到首页问题 #

该问题几乎都是请求被WordPress路由规则截胡，未进入Laravel路由匹配流程导致：

• 调整public/.htaccess规则优先级，将Laravel路由转发规则放在WordPress规则之前，参考配置如下：

  RewriteEngine On
  
  # 专属Laravel的路由前缀优先转发到Laravel入口
  RewriteRule ^(donor|parent|account|admin)/?(.*)$ /index.php?$2 [L]
  
  # 恢复尾斜杠重定向规则，避免路由匹配异常
  RewriteCond %{REQUEST_FILENAME} !-d
  RewriteRule ^(.*)/$ /$1 [L,R=301]
  
  # 以下为WordPress默认规则，保持不变
  # BEGIN WordPress
  <IfModule mod_rewrite.c>
  RewriteEngine On
  RewriteBase /
  RewriteRule ^index\.php$ - [L]
  RewriteCond %{REQUEST_FILENAME} !-f
  RewriteCond %{REQUEST_FILENAME} !-d
  RewriteRule . /index.php [L]
  </IfModule>
  # END WordPress
  

• 重新生成路由缓存：
  执行php artisan route:cache命令重新生成路由缓存，执行前确认storage、bootstrap/cache目录权限为755，所属用户为Web服务运行用户（如www-data），避免缓存写入失败。
• 验证路由是否正常注册：
  执行php artisan route:list | grep donor命令，确认/donor相关路由存在，如果无输出，检查app/Providers/RouteServiceProvider.php中是否漏了对应路由文件的加载逻辑。

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