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
相关产品推荐
相关产品推荐

