URL 重写规则和静态资源解析逻辑

问题背景

最近部署博客页面时遇到这样的问题:同样的页面结构,部署到我的两个域名下:dodolalorc.cn 和 dodolalorc.github.io,对应的网页内容是相同的,但是 dodolalorc.cn 需要写成https://dodolalorc.cn/links.html才能显示内容,否则会报404,dodolalorc.github.io就不需要这样。

原因记录

这种差异主要源于两个域名所对应的服务器配置不同,本质原因是服务器如何解析 "无后缀 URL"。

我的 dodolalorc.cn 配置在服务器上,而 dodolalorc.github.io 将走 github page 的代理。

当访问一个 URL(如a.github.io/about或a.cn/about)时,服务器需要判断这个请求对应的实际文件是什么。

  • 对于a.github.io/about:服务器被配置为 "自动补全.html后缀",即自动将about解析为about.html,因此能找到对应的文件并返回内容。
  • 对于a.cn/about:服务器没有配置自动补全后缀 ,它会严格按照请求的路径查找文件(即寻找about这个 "无后缀文件"),但实际文件是about.html,因此找不到,返回 404;只有手动加上.html(即a.cn/about.html),才能匹配到实际文件。

a.github.io通常是托管在GitHub Pages上的静态网站,而 GitHub Pages 默认配置了 "友好 URL 规则",会自动处理无后缀的 URL 请求。具体逻辑包括:

  • 自动补全.html后缀 :当请求/about时,服务器会先检查是否存在about.html文件,若存在则直接返回。
  • 支持目录索引 :如果about是一个文件夹,服务器会自动查找about/index.html(即默认索引文件)。

这种配置是 GitHub Pages 为了简化静态网站访问而预设的,目的是让 URL 更简洁(如xxx/about比xxx/about.html更易读)。

a.cn对应的服务器没有配置 "自动补全.html" 的规则,因此遵循 "严格匹配" 逻辑:

  • 当请求a.cn/about时,服务器会直接查找名为about的 "无后缀文件"(而非about.html)。
  • 由于实际文件是about.html(而非about),服务器找不到对应资源,就会返回 404 错误。
  • 只有手动指定完整文件名about.html,才能匹配到实际文件,因此a.cn/about.html能正常访问。

解决方法

我的服务器使用 Nginx 服务器,于是选择在 Nginx 的站点配置中添加:

nginx 复制代码
location / {
    # 当请求的文件不存在时,尝试补全.html
    if (!-e $request_filename) {
        rewrite ^(.*)$ $1.html last;
    }
}

配置后,a.cn/about会被自动解析为a.cn/about.html,无需手动加后缀。

相关推荐
数据掘金16 分钟前
百度统计后台页面数据异常?从手动调用时机开始排查
前端
hunteritself17 分钟前
10 层 4K 实时剪辑,国产工作站进入广电制作核心
大数据·前端·人工智能·深度学习·transformer
踩着两条虫18 分钟前
我在浏览器里“盖”了一个村:Vue + Three.js 大屏开发踩坑记
前端·vue.js·three.js
mbshqqb23 分钟前
TypeScript基础教程之同步生成器
前端·javascript·typescript
嘟嘟同学和妮妮同学41 分钟前
【升级】一个中国历史可视化站:皇帝时间线梳理、古代思想流派、诗词鉴赏 (2)
前端·html
暗夜行者之光1 小时前
LangGraph + MCP 实战:构建"自然语言查数据"的 ChatBI Agent
前端·后端
一tiao咸鱼1 小时前
还在手动海投?我做了个 AI 求职助手,自动筛选 BOSS 职位再精准投递
前端·后端·面试
尤水就下1 小时前
🔥预热:在线文档的 block 架构是如何实现的(未完待续...)
前端·javascript·架构
全栈项目管理程序猿2 小时前
ArcGIS JS 基础教程(29):CSVLayer 表格点位图层
前端·javascript
骑着蜗牛撵大象3272 小时前
豆包 Seed 驱动的记账智能体:从拍票抽取到月报生成的全链路落地记录
java·前端·javascript·结构化输出·豆包seed·多模态识别·记账系统