Python3使用SimpleHTTPRequestHandler运行HTTP服务时404问题的解决

你现在的代码存在三个直接导致页面加载失败的问题：

• 相对路径基准错位
  SimpleHTTPRequestHandler查找静态文件的根路径，是启动Python脚本时终端所在的当前工作目录（CWD），既不是脚本存放目录，也不是用户家目录。你写的./desktop/formdailyactivities/index.html，本质是从CWD开始向下查找文件，如果启动脚本时的CWD不是用户家目录，这个路径根本不存在，自然返回404。
• 提前发送响应头造成逻辑冲突
  你在else分支里手动调用了self.send_response(200)，但SimpleHTTPRequestHandler的父类do_GET方法本身就会根据文件查找结果、文件读取流程自动处理响应码、响应头。提前发出的200响应头会和父类后续的响应逻辑冲突，甚至因为响应头已经发出，父类找不到文件想返回404时也没法修正响应状态，直接导致页面加载异常。
• 带查询参数的路径被当成静态文件路径
  当访问带参数的接口（比如/submit?activity=吃饭）时，你没有把self.path里的查询参数（?activity=...部分）去掉，直接把带查询串的完整字符串传给父类查找文件——父类会把整串字符当成文件名匹配，当然找不到任何文件，直接报404。

1. 提前固定静态文件的查找根目录，避免相对路径错位：在启动服务前，用os.chdir()把工作目录切到index.html实际存放的文件夹，不管在哪个目录启动脚本，都能正确找到静态文件。
2. 删掉else分支里提前写的self.send_response(200)，把常规响应流程交给父类处理。
3. 拆分请求路径和查询参数：遇到需要处理业务逻辑（比如写数据库）的接口路径，解析完参数、执行完逻辑后手动返回响应，不要把这类带参数的路径丢给父类走静态文件查找流程。
4. 根路径映射直接写/index.html即可，不需要带./前缀，父类会自动基于切换好的工作目录拼接正确的文件路径。

import http.server
import socketserver
from furl import furl
import os

# 提前切到index.html所在的实际目录，解决相对路径找错的问题
HTML_DIR = os.path.expanduser("~/desktop/formdailyactivities")
os.chdir(HTML_DIR)

class MyServer(http.server.SimpleHTTPRequestHandler):
    def do_GET(self):
        print("收到请求：", self.path)
        # 拆分纯路径和查询参数
        req = furl(self.path)
        pure_path = req.pathstr

        # 处理业务接口（比如原来的数据库写入逻辑）
        if pure_path == "/submit":
            activity = req.args.get("activity")
            time = req.args.get("time")
            date = req.args.get("date")
            # 这里替换成你实际的数据库插入逻辑
            # s1.insert(activity, time, date)
            
            # 手动返回接口响应
            self.send_response(200)
            self.send_header("Content-type", "text/plain; charset=utf-8")
            self.end_headers()
            self.wfile.write("数据提交成功".encode("utf-8"))
            return

        # 剩下的请求走静态文件逻辑
        if pure_path == "/":
            self.path = "/index.html"
        else:
            self.path = pure_path
        
        # 交给父类处理静态文件的读取和响应
        super().do_GET()

PORT = 8080
if __name__ == "__main__":
    with socketserver.TCPServer(("", PORT), MyServer) as httpd:
        print(f"服务已启动，访问 http://localhost:{PORT}")
        httpd.serve_forever()

• 不要把需要处理业务的接口路径和静态文件路径混着用，业务逻辑处理完成后要直接return，不要继续走父类的静态文件查找逻辑
• 不确定相对路径是否正确时，直接在代码里打印os.getcwd()查看当前工作目录，再打印待访问文件的完整路径（os.path.abspath(self.path)），确认文件是否真实存在，就能快速定位404的原因
• TCPServer实例最好用上下文管理器（with语句）启动，避免端口占用时无法正常释放资源

内容的提问来源于stack exchange，提问作者S.M_Emamian