Lumen仅默认路由可正常访问 非默认路由报500服务错误如何解决

错误根因 #

该报错是Lumen服务容器中未绑定Illuminate\Contracts\Http\Kernel接口对应的实现类导致的。根路由默认不需要触发内核解析逻辑所以能正常访问，访问其他路由时会触发内核/中间件解析流程，就会抛出不可实例化的错误。

排查解决步骤 #

• 第一步：校验Nginx重写规则 #

  先确认Nginx站点配置中所有非静态资源请求都正确转发到Lumen的入口文件，避免请求路径解析异常触发错误，配置示例如下：

  server {
      listen 80;
      server_name 你的域名;
      root 你的项目路径/public;
      index index.php index.html;
  
      location / {
          try_files $uri $uri/ /index.php?$query_string;
      }
  
      location ~ \.php$ {
          fastcgi_pass   127.0.0.1:9000;
          fastcgi_index  index.php;
          fastcgi_param  SCRIPT_FILENAME  $realpath_root$fastcgi_script_name;
          include        fastcgi_params;
      }
  }
  

  配置修改完成后执行nginx -s reload重载配置，再测试路由是否正常。

• 第二步：手动绑定Http内核契约 #

  Lumen作为轻量框架默认不会自动创建和绑定Http内核类，需要手动创建后完成绑定：
  1. 新建app/Http/Kernel.php文件，写入如下代码：

  <?php
  namespace App\Http;
  
  use Illuminate\Contracts\Http\Kernel as KernelContract;
  use Laravel\Lumen\Http\Kernel as BaseKernel;
  
  class Kernel extends BaseKernel implements KernelContract
  {
      // 全局中间件
      protected $middleware = [];
  
      // 路由中间件
      protected $routeMiddleware = [];
  }
  

  2. 打开bootstrap/app.php文件，添加内核绑定代码：

  $app->singleton(
      Illuminate\Contracts\Http\Kernel::class,
      App\Http\Kernel::class
  );
  

• 第三步：清理缓存重试 #

  执行如下命令清理项目缓存：

  php artisan cache:clear
  php artisan config:clear
  

  重启服务后再次访问非默认路由验证是否正常。

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