Python BaseHTTPRequestHandler加载CSS但不渲染问题求助

问题现象 #

基于BaseHTTPRequestHandler实现的Python服务器，可正常返回index.html文件及style.css请求（浏览器控制台显示CSS请求返回200 OK），但Firefox、Konqueror等浏览器加载页面时无法应用CSS样式。直接本地打开index.html文件时样式正常，说明问题出在服务器代码逻辑中。

服务器代码 #

class MyServer(BaseHTTPRequestHandler):
    def do_GET(self):
        if (self.path.endswith("/")):
            self.send_response(200)
            self.send_header("Content-type", "text/html")
            self.end_headers()
            with open('index.html', 'r') as file:
                template = file.read()
            self.wfile.write(bytes(eval_template(template, env).encode("utf-16")))
        
        elif (self.path.endswith(".css")):
            with open(os.path.join('.', self.path[1:]), 'rb') as file:
                response = file.read()
            self.send_response(200)
            self.send_header("Content-type", "text/css")
            self.end_headers()
            self.wfile.write(response)

index.html中的CSS引用 #

<link rel="stylesheet" type="text/css" href="style.css" />

问题原因及修复方案 #

核心问题：HTML响应编码未声明，且使用非通用编码 #

服务器返回HTML内容时，使用了utf-16编码，但仅设置Content-type: text/html，未指定字符集。浏览器默认以utf-8解析HTML，导致内容编码不匹配，可能使<link>标签的引用路径被错误解析——即使CSS请求返回200，浏览器也无法正确关联样式文件。

修复步骤 #

1. 推荐：改用Web通用的utf-8编码
   修改HTML响应部分的代码，统一使用utf-8编码并在响应头中声明：

   if (self.path.endswith("/")):
       self.send_response(200)
       # 添加字符集声明
       self.send_header("Content-type", "text/html; charset=utf-8")
       self.end_headers()
       with open('index.html', 'r') as file:
           template = file.read()
       # 直接返回utf-8编码的bytes，无需冗余的bytes()包裹
       self.wfile.write(eval_template(template, env).encode("utf-8"))
   

2. 若需保留utf-16编码
   必须在响应头中明确声明字符集，避免浏览器解析错误：

   self.send_header("Content-type", "text/html; charset=utf-16")
   

额外优化建议 #

• 补充处理直接请求/index.html的场景：当前代码仅处理以/结尾的请求，若用户直接访问/index.html会返回404，可修改判断逻辑：

  if self.path.endswith("/") or self.path == "/index.html":
  

• 添加异常捕获：在打开文件时增加try-except块处理FileNotFoundError，返回404响应，避免服务器崩溃。

内容的提问来源于stack exchange，提问作者Mr. Wrong