最常见 server_name 配置错误是 host 请求头与 server_name 不匹配，导致进入 default 站点或返回 404；nginx 不解析 dns，仅字符串比对，需确保完全一致（如 blog.example.com），本地测试须配 /etc/hosts。
nginx 配置虚拟主机时 server_name 写错导致 404 或默认站点生效
最常见的情况是访问域名却进了 default 站点，或者返回 404 —— 很可能 server_name 没匹配上。Nginx 不做 DNS 解析，只比对 Host 请求头和 server_name 字符串是否一致（支持通配符和正则，但别乱用）。
实操建议：
-
server_name必须和你实际请求的 Host 完全一致，比如用户访问https://blog.example.com，配置里就得写server_name blog.example.com;，不能漏掉子域或写成example.com - 本地测试时，记得改
/etc/hosts，把域名指向本机 IP，否则浏览器根本发不出带正确 Host 的请求 - 多个域名共用一个配置？用空格分隔：
server_name example.com www.example.com;，不要换行或加逗号 - 想匹配所有子域？写
server_name ~^\.example\.com$;，但注意正则性能略低，且必须以~开头，否则当字面量处理
root 和 location 中的 root / alias 混用引发 403 或文件找不到
root 是拼路径的基准，alias 是直接替换 URI 路径段 —— 这俩逻辑完全不同，混用就会丢目录、多一层、少一层，结果就是 403 Forbidden 或 404 Not Found。
实操建议：
- 静态站点根目录统一用
root：比如root /var/www/blog;，再配location / { }，访问/index.html就找/var/www/blog/index.html - 要映射某个 URI 到完全不同的物理路径，才用
alias：比如location /media/ { alias /data/uploads/; }，访问/media/photo.jpg实际读/data/uploads/photo.jpg（注意结尾斜杠必须一致） -
alias后路径末尾必须有/，且location路径末尾也得有/，否则 Nginx 会把 URI 全部拼进去，导致路径错乱 - 不确定该用哪个？优先用
root，更直观；只有明确需要“URI 到路径重定向”时才选alias
HTTPS 站点 reload 失败：证书路径错误或权限不足
加了 ssl_certificate 和 ssl_certificate_key 后 nginx -t 通过，但 systemctl reload nginx 报错，大概率是路径不对或 Nginx 工作用户（通常是 www-data 或 nginx）没权限读证书文件。
实操建议：
- 证书路径必须写绝对路径，比如
ssl_certificate /etc/nginx/ssl/blog.example.com.crt;，相对路径在 reload 时会相对于配置所在目录，极易出错 - 检查证书文件权限：
ls -l /etc/nginx/ssl/，确保私钥.key文件权限是600或640，且属组包含 Nginx 用户（如chown root:www-data blog.example.com.key && chmod 640 blog.example.com.key） - 如果证书链合并了中间 CA，确保顺序是：站点证书 → 中间证书 → （不包括根证书），否则某些客户端握手失败
- OpenSSL 版本太老（如 CentOS 7 自带的 1.0.2）不支持 TLSv1.3，若配置了
ssl_protocols TLSv1.2 TLSv1.3;会导致启动失败，可先注释掉 TLSv1.3 测试
配置生效后浏览器仍走旧缓存：不是 Nginx 问题，是本地或 CDN 缓存干扰
明明 reload 成功、curl -I 返回新内容，但浏览器打开还是旧页面——这几乎可以确定不是 Nginx 配置问题，而是缓存层在捣鬼。
实操建议：
- 先用
curl -H "Host: your-domain.com" http://127.0.0.1绕过 DNS 和 Host 绑定，确认 Nginx 本身响应正确 - 浏览器按
Ctrl+Shift+R（强制刷新），或开无痕窗口，排除本地 HTTP 缓存和 HSTS - 如果用了 Cloudflare 或其他 CDN，检查其缓存设置，可能把 HTML 缓存了 30 分钟，改完配置也要等它过期或手动 Purge
- Nginx 自身缓存（如
proxy_cache）默认不开启，但如果启用了，记得清缓存：rm -rf /var/cache/nginx/*并nginx -s reload
