You need to enable JavaScript to run this app. Laravel 8 配置API子域名路由(domain方法)后接口无法访问
优惠活动
大模型
产品
解决方案
定价
更多

Laravel 8 配置API子域名路由(domain方法)后接口无法访问

报错核心原因

getaddrinfo ENOTFOUND api.rest-api.test 是DNS解析层面的错误,与Laravel路由逻辑本身无关:发起请求的设备无法将api.rest-api.test这个域名解析到对应服务的IP地址,请求根本没有到达Web服务器,自然无法触发路由匹配流程。
之前使用prefix()配置时接口可正常访问,是因为当时请求的主域名(如rest-api.test)已经提前完成了解析和虚拟主机配置,更换为子域名路由后,两个关键配置环节缺失才导致报错。

分步解决流程

1. 配置本地域名解析映射

.test后缀为本地开发使用的伪域名,无法通过公共DNS解析,需要手动在本机hosts文件中添加映射:

  • Windows 对应文件路径:C:\Windows\System32\drivers\etc\hosts
  • Mac/Linux 对应文件路径:/etc/hosts
  • 新增映射规则(IP与原有主域名的解析地址保持一致):
    127.0.0.1 api.rest-api.test
    

如果使用Laravel Valet作为本地开发环境,可将项目所在目录通过valet park纳入自动解析范围,Valet会自动为所有.test后缀的子域名生成解析规则,无需手动修改hosts文件。

2. 配置Web服务器的子域名虚拟主机

完成解析映射后,需要让本地Nginx/Apache/内置开发服务器识别该子域名的请求,将请求转发到对应Laravel项目的public目录:

  • 如果使用php artisan serve启动开发服务:需要指定host参数启动,否则内置服务器只会响应固定地址的请求:
    php artisan serve --host=api.rest-api.test --port=80
    
  • 如果使用Nginx/Apache本地环境:需要在站点配置中新增api.rest-api.test的server_name配置项,站点根目录指向当前Laravel项目的public文件夹,与原有rest-api.test站点的目录配置保持一致即可。

3. 修正Laravel环境变量的读取方式

不要在路由服务提供者中直接使用env()读取环境变量:Laravel生成配置缓存后,env()在config目录外的文件中将始终返回null,会直接导致域名匹配失效。

  • 在config/api.php中新增配置项:
    'domain' => env('API_DOMAIN'),
    
  • 将RouteServiceProvider中的路由绑定代码修改为:
    Route::domain(config('api.domain'))
        ->middleware('api')
        ->namespace($this->namespace)
        ->group(base_path('routes/api.php'));
    

4. 清除缓存并验证

依次执行命令清除旧配置缓存,避免历史缓存干扰新规则生效:

php artisan config:clear
php artisan route:clear

验证时注意Postman的请求地址要匹配新的域名规则,直接访问http://api.rest-api.test/person即可,不需要保留之前的/api路径前缀。

内容的提问来源于stack exchange,提问作者Newb 4 You BB

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.08 06:27:01