Laravel 7.28本地XAMPP子域名路由配置后访问异常问题排查

问题根因 #

你遇到的两个访问异常，本质上请求都没走到Laravel的路由匹配层，核心是本地环境配置缺失，再加上代码细节有问题：

• 访问demo.myapp.com提示无法访问，属于网络层就中断了：
• 本地没有配置对应的域名解析规则，浏览器根本不知道demo.myapp.com要往哪个地址发请求，自然无法连接到服务
• 就算手动改了hosts把域名指向本地，XAMPP的Apache也没有绑定对应项目的虚拟主机规则，请求会直接落到Apache默认的站点目录，根本不会进入Laravel的处理流程
• 访问demo.localhost和localhost返回完全一致的内容，也是没触达子域名路由的匹配逻辑：
• XAMPP默认只识别纯localhost的主站请求，没有配置支持任意子域名的localhost虚拟主机规则，所有子域名请求都会被转发到默认主站，和直接访问主站没有区别
• 代码层面存在参数不匹配的问题：路由组里定义的子域名占位变量是{domain}，但是控制器方法接收的参数名是$subdomain，就算请求走到路由层，Laravel也没法自动把子域名参数注入到方法里
• 路由优先级有问题：如果路由文件里先定义了根域名下的同路径路由，访问/的时候会优先匹配更明确的根域名路由，永远走不到子域名路由组的逻辑

落地修复步骤 #

• 配置本地hosts文件
  Windows系统路径：C:\Windows\System32\drivers\etc\hosts，macOS/Linux系统路径：/etc/hosts
  在文件末尾追加解析规则，保存后无需重启系统即时生效：

127.0.0.1 localhost
127.0.0.1 demo.myapp.com
127.0.0.1 demo.localhost

如果需要测试任意子域名，可以手动加上127.0.0.1 *.myapp.com的规则，注意部分Windows版本不支持通配符hosts，逐行加具体子域名最稳妥。

• 配置XAMPP的Apache虚拟主机
  打开XAMPP安装目录下的apache/conf/extra/httpd-vhosts.conf，清空原有默认配置后写入以下规则，注意把项目路径替换成你自己Laravel项目的public目录绝对路径：

# 保留原localhost主站配置
<VirtualHost *:80>
    DocumentRoot "C:/xampp/htdocs"
    ServerName localhost
    ServerAlias *.localhost
</VirtualHost>
# 绑定Laravel项目的myapp.com泛域名规则
<VirtualHost *:80>
    DocumentRoot "C:/xampp/htdocs/你的Laravel项目/public"
    ServerName myapp.com
    ServerAlias *.myapp.com
</VirtualHost>

写完之后打开apache/conf/httpd.conf，找到LoadModule vhost_alias_module modules/mod_vhost_alias.so这一行，把行首的注释#去掉，保存后重启Apache服务。

• 修正代码层面的参数问题
  把控制器方法的参数名和路由里的占位符对齐，比如路由组里用的是{domain}占位子域名，控制器就不能写$subdomain参数：

class HomeController extends Controller
{
    // 错误写法：参数名和路由占位符不匹配
    // public function index($subdomain)

    // 正确写法：参数名和路由定义保持一致
    public function index($domain)
    {
        // 这里可以拿到传入的子域名值，用来做租户归属校验
        dd("当前访问的子域名是：" . $domain);
    }
}

• 调整路由优先级
  把你写的子域名路由组放在routes/web.php文件的最顶部，避免被同路径的根域名路由提前匹配。比如不要在文件开头就写Route::get('/', 'HomeController@index')这种根域名路由，不然访问根路径的时候会优先命中更明确的根路由，永远走不到通配子域名的路由组。

常见踩坑提醒 #

• 本地XAMPP环境没有自动泛域名解析的能力，所有自定义域名都必须手动在hosts里配置指向，不然浏览器永远解析不到对应的服务地址
• 如果配置完还是访问不通，先不要急着改Laravel代码，直接在终端用ping demo.myapp.com看返回的IP是不是127.0.0.1，如果不是，说明是hosts或者Apache配置的问题，和Laravel没关系
• 子域名占位符默认只匹配单级子域名，如果要匹配a.b.demo.localhost这种多级域名，需要在路由组里给占位符加正则约束，比如Route::domain('{subdomain:.*?}\.localhost')

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