如何解决HTTP服务器访问文件名含%字符的文件报404的问题

核心触发原因 #

根据HTTP的URL解析规范，%是*百分号编码（URL编码）*的专用起始标识，所有特殊字符的转义格式都是%搭配两位十六进制数。
你直接在请求里写/s%22.txt时，服务端会自动按编码规则解析路径：把%22识别成双引号"，最终实际去磁盘查找的文件是s".txt，和你创建的s%22.txt文件名完全不匹配，因此返回404。
你测试不含%的文件名可以正常访问，是因为这类文件名中不存在URL保留字符，服务端解码后得到的路径和实际文件名完全一致，因此可以正常匹配。不管是Python内置http.server还是Node.js的http-server，都会严格遵循这个标准URL解析逻辑，所以切换服务也不会解决这个问题。

正确的访问方法 #

要访问文件名中包含%的文件，需要对文件名里的%字符本身做单独的URL转义，把单个%替换为编码后的%25：

• 实际磁盘文件名：s%22.txt
• 正确的请求路径：/s%2522.txt
  对应的完整curl请求命令为：
  curl http://127.0.0.1:8000/s%2522.txt

解析链路说明：服务端收到路径/s%2522.txt后，会执行标准URL解码流程：

1. 先将路径中的%25解码还原为原字符%
2. 最终解码得到的路径字符串为s%22.txt，和磁盘上的实际文件名完全匹配，即可正常返回文件内容。

通用注意事项 #

• 只要文件名/访问路径中包含%字符，在HTTP请求URL中就必须将其编码为%25，不能直接书写原始%字符
• 本规则是标准HTTP服务的通用实现逻辑，和使用的静态服务类型无关，所有合规静态服务都会按此规则解析路径
• 文件名中其他非保留字符不需要额外编码，仅需针对%字符做转义即可

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