Linux环境下Flask处理带重音字符URL的问题解决

问题根源 #

Windows本地使用Flask内置测试服务器时，Werkzeug直接处理HTTP请求，不会对URL路径做额外编码，因此request.url能直接返回正确的原始URL。但Linux下的WSGI服务器（如Apache+mod_wsgi、uWSGI、Gunicorn等）会在将请求传递给Flask前，对URL路径做一次URL编码，导致Flask构建request.url时再次编码，最终出现双重编码结果（比如é被二次编码为%25c3%25a9）。

解决方案 #

方案1：配置WSGI服务器传递原始路径 #

针对不同的WSGI服务器调整配置，避免二次编码：

• uWSGI：启动时添加参数--decodeuri 1，让uWSGI自动解码路径后再传递给Flask。
• Apache+mod_wsgi：在虚拟主机配置中添加WSGIApplicationGroup %{GLOBAL}，确保路径以原始形式传递。
• Gunicorn：若前端有Nginx反向代理，需确保Nginx传递$request_uri而非编码后的路径，Gunicorn本身无需额外配置。

方案2：手动构建正确的URL #

如果无法修改服务器配置，可绕过request.url，直接从Flask请求对象的原生属性构建正确URL：

from urllib.parse import quote
from flask import request

def get_raw_url():
    # request.path是已解码的路径，按规则重新编码
    encoded_path = quote(request.path, safe='/;_')
    # 拼接主机地址与编码后的路径
    url = request.host_url.rstrip('/') + encoded_path
    # 追加查询参数（若存在）
    if request.query_string:
        url += '?' + request.query_string.decode('utf-8')
    return url

# 在路由中使用
@app.route('/onto/debug/<id>') 
def debug(id):
    uri = get_raw_url()
    res = render_template("debug.html", uri=uri).encode('utf-8')
    return res

其中safe='/;_'指定无需编码的字符，可根据你的URL规则调整。

方案3：针对性解码（临时过渡方案） #

若仅需临时兼容环境，可通过运行环境判断是否解码：

from urllib.parse import unquote
from flask import request, current_app

@app.route('/onto/debug/<id>') 
def debug(id):
    uri = request.url
    # 非调试模式（WSGI生产环境）下执行一次解码
    if not current_app.debug:
        uri = unquote(uri, encoding='utf-8', errors='replace')
    res = render_template("debug.html", uri=uri).encode('utf-8')
    return res

该方法依赖debug模式判断，仅适合测试过渡阶段，不推荐长期使用。

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