Laravel如何仅发布API路由并优化API访问路径

一、消除/api路径重复问题 #

Laravel默认会给routes/api.php内的所有路由自动加上/api前缀，这个规则在App\Providers\RouteServiceProvider中定义。由于你的API已部署在/api/my-application路径下，需要移除默认前缀来避免重复：

1. 打开app/Providers/RouteServiceProvider.php，找到mapApiRoutes方法，删除prefix('api')这一行：

   protected function mapApiRoutes()
   {
       Route::middleware('api')
           ->namespace($this->namespace)
           ->group(base_path('routes/api.php'));
   }
   

2. 调整routes/api.php中的路由定义，比如原登录路由：

   Route::post('/login', [AuthController::class, 'login']);
   

   现在访问路径直接变为http://localhost/api/my-application/login，不再出现重复的/api。

二、解决根路径500错误（View [welcome] not found） #

访问http://localhost/api/my-application/时，Laravel会匹配routes/web.php的默认根路由，而默认根路由会尝试返回welcome视图。针对纯API项目，可通过以下方式处理：

方法1：完全禁用Web路由 #

如果项目不需要任何Web视图路由，直接在RouteServiceProvider.php的map方法中注释掉Web路由的映射：

public function map()
{
    $this->mapApiRoutes();

    // $this->mapWebRoutes(); // 注释此行，禁用Web路由
}

同时在routes/api.php中添加根路由的响应逻辑：

Route::get('/', function () {
    return response()->json(['status' => 'success', 'message' => 'API service is running']);
});

方法2：修改Web根路由 #

若需要保留Web路由，直接修改routes/web.php的根路由，让它返回API格式响应：

Route::get('/', function () {
    return response()->json(['status' => 'success', 'message' => 'API service is running']);
});

额外检查（可选） #

确保Web服务器（Nginx/Apache）的重写规则正常：

• Nginx需配置正确的try_files规则：

  location /api/my-application {
      try_files $uri $uri/ /api/my-application/index.php?$query_string;
  }
  

• Apache需启用mod_rewrite模块，且Laravel根目录下的.htaccess文件正常生效。

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