Nginx server_name模糊匹配需通过真实Host头请求验证分发结果：精确命中、模糊覆盖、意外兜底三类场景须用curl -H模拟，并借助X-Server响应头、nginx -T核对配置、error.log排查警告，显式设置default_server和server_name _确保fallback可控。
测试 server_name 模糊匹配（如通配符 *.example.com、正则 ~^api\d+\.example\.com$）在不同 Host 请求头下的实际表现，关键不是“写对了没”，而是看 Nginx 运行时**是否按预期把请求分发到对应 server 块**。重点验证三类典型请求：精确命中、模糊覆盖、意外兜底。
用 curl 构造不同 Host 头发起真实请求
直接模拟客户端行为最可靠。确保目标域名 DNS 已解析到该 Nginx 服务器 IP（或用 --resolve 强制映射），然后逐条测试：
-
curl -H "Host: api1.example.com" http://127.0.0.1/→ 应匹配正则~^api\d+\.example\.com$ -
curl -H "Host: blog.example.com" http://127.0.0.1/→ 应匹配通配符*.example.com -
curl -H "Host: example.com" http://127.0.0.1/→ 不应匹配*.example.com（通配符不覆盖根域），应落到其他块或兜底块 -
curl -H "Host: TEST.EXAMPLE.COM" http://127.0.0.1/→ 精确匹配example.com是大小写不敏感的，仍会命中 -
curl http://127.0.0.1/（无 Host 头）→ 默认匹配server_name ""块（0.8.48+ 自动生效），或第一个listen块
配合 access_log 和自定义响应头确认路由走向
在每个 server 块中加一句唯一标识，避免靠猜测判断：
- 在
server { server_name ~^api\d+\.example\.com$; ... }块里加：add_header X-Server "api-regex"; - 在
server { server_name *.example.com; ... }块里加：add_header X-Server "wildcard-sub"; - 在兜底块（
server_name _;或未设default_server的首个块）加：add_header X-Server "fallback";
然后用 curl -I 查看响应头，一眼确认匹配结果：curl -I -H "Host: admin.example.com" http://127.0.0.1/ | grep X-Server
检查配置加载后是否真正生效
模糊匹配容易因配置顺序、重复定义或语法错误被静默忽略：
- 运行
nginx -t验证语法正确 - 执行
nginx -T | grep "server_name"查看最终合并后的全部server_name列表，人工核对有无重复、冲突或意外遗漏（例如两个块都写了server_name *.example.com） - 重载配置后立刻查
tail -f /var/log/nginx/error.log，Nginx 若发现模糊匹配歧义（如正则格式错误、通配符位置非法），会在 error.log 中报 warning，比如invalid number of arguments in "server_name" directive
特别注意 fallback 行为的可控性
未匹配 Host 头的请求默认交给该 listen 下第一个 server 块——这个行为常被误认为“配置失效”。建议显式控制：
- 给明确用途的块加上
default_server标志：listen 80 default_server; - 兜底块用
server_name _;并返回明确响应：return 444;或return 404;，避免静默转发 - 测试时故意发一个不存在的 Host（如
curl -H "Host: fake.test" http://127.0.0.1/），观察是否真走到你设定的兜底逻辑
