Skip to content

Bug #001: 中文文件名导致 URI 解码错误

现象

Epub 电子书阅读器页面打开后空白,ifame 加载的 HTML 页面返回 HTTP 500。

根因

public/books/ 下的文件名包含中文字符(如 小狗钱钱.epubreader-富爸爸穷爸爸.html)。

Vite 开发服务器在处理静态文件请求时,对含中文的 URI 执行 decodeURI() 失败,抛出 URI malformed 错误。

修复

将所有 public/ 目录下的文件名改为英文/拼音:

旧文件名新文件名
小狗钱钱.epubmoney-dog.epub
富爸爸系列套装5册.epubrich-dad-series.epub
reader-小狗钱钱.htmlreader-money-dog.html
reader-富爸爸穷爸爸.htmlreader-rich-dad.html

同步更新所有引用路径(VitePress MD 页面、独立 HTML 内的 epub 路径)。

规则

此后 public/ 目录下所有文件名统一使用英文/拼音,禁止中文文件名。

关联文件

  • public/books/*
  • 01-personal-finance/books/小狗钱钱.md
  • 01-personal-finance/books/富爸爸穷爸爸.md
  • 01-personal-finance/resources.md

金融知识学习笔记