含中文的URL请求触发'latin-1'编码错误，求解决方法

嘿，这个问题我之前踩过一模一样的坑！本质就是浏览器把中文URL编码成UTF-8格式的百分号串，但后端默认用'latin-1'去解码，结果搞不定多字节的UTF-8编码，就抛出那个ordinal not in range(256)的错误了。下面给你一套完整的解决办法，分不同场景来说：

先搞懂问题根源 #

浏览器复制带中文的URL时，会自动把中文转成UTF-8的百分号编码（比如你看到的%E5%9F%9F%E5%90%8D%E7%BB%91%E5%AE%9A），但很多后端框架（比如Django、Flask）默认会按照'latin-1'来解码URL路径——这是HTTP早期的旧标准，但现在UTF-8才是主流，所以就冲突报错了。

分场景解决办法 #

1. 如果你用的是Django框架 #

• 全局配置强制UTF-8解码：在项目的settings.py里加一行，让整个项目的URL解码都用UTF-8：

  FORCE_TEXT_ENCODING = 'utf-8'
  

• 媒体文件服务的特殊处理：如果是像你这样的媒体图片请求，在urls.py配置静态服务时，指定编码为UTF-8：

  from django.conf import settings
  from django.conf.urls.static import static
  from django.views.static import serve
  
  urlpatterns += [
      url(r'^media/(?P<path>.*)$', serve, {
          'document_root': settings.MEDIA_ROOT,
          'encoding': 'utf-8',  # 明确指定用UTF-8解码路径
      }),
  ]
  

• 手动处理路径的视图函数：如果你的视图是自己写的文件读取逻辑，记得手动修复编码：

  from django.http import HttpResponse
  
  def serve_image(request, path):
      # 先把框架用latin-1解码的字符串转回字节，再用UTF-8解码出正确中文路径
      decoded_path = path.encode('latin-1').decode('utf-8')
      # 然后正常读取文件返回就行
      return HttpResponse(open(decoded_path, 'rb'), content_type='image/png')
  

2. 要是你用的是Flask框架 #

Flask同样会有这个默认编码问题，在路由里手动修复编码就行：

from flask import Flask, request

app = Flask(__name__)

@app.route('/media/<path:path>')
def serve_media(path):
    # 同样的思路：反向编码再解码
    decoded_path = path.encode('latin-1').decode('utf-8')
    return app.send_file(decoded_path)

3. 生产环境用Nginx反向代理的情况 #

如果部署的时候用了Nginx，要确保Nginx传递URL时保留UTF-8编码，在Nginx配置里加这些：

server {
    listen 80;
    server_name localhost;

    location /media/ {
        charset utf-8;
        default_type application/octet-stream;
        root /你的媒体文件根路径;
        # 确保URL按UTF-8解析
        rewrite ^/(.*)$ /$1 break;
        try_files $uri $uri/ =404;
    }
}

验证是否解决 #

直接访问编码后的URL，看看能不能正常显示图片；或者在后端日志里打印一下解码后的路径，应该能看到正确的中文“域名解析.png”，那就说明没问题了。

这个方法的核心就是：把框架错误用'latin-1'解码出来的字符串，先转回字节，再用UTF-8重新解码，就能还原出正确的中文路径，自然就不会报错啦。

内容的提问来源于stack exchange，提问作者sof-03