Flask路由参数传递时Unicode字符串编码异常问题求助

这个问题我之前也碰到过！你已经搞定了JSON输出的编码问题（设置JSON_AS_ASCII=False），但路由参数的解码其实是输入环节的独立问题，和返回JSON的序列化不是一回事，咱们一步步来排查解决：

1. 先确认客户端是否正确编码URL中的Unicode字符 #

URL本身只能包含ASCII字符，所以任何Unicode字符都需要转成百分号编码格式（比如中文“测试”要转成%E6%B5%8B%E8%AF%95）。很多REST客户端默认会自动处理，但有些工具可能没做这个，导致Flask收到的是乱码原始字符，自然解析不对。

你可以先检查下调用的URL：如果直接在URL里写了Unicode字符（比如/user/测试），那肯定会出问题——必须让客户端先把Unicode转成百分号编码后再发送请求。

2. 手动兜底解码路由参数（如果客户端无法修改） #

如果因为某些原因客户端没法正确编码，你可以在Flask视图函数里手动对路由参数进行解码，用Python标准库的urllib.parse.unquote：

from flask import Flask, jsonify
from urllib.parse import unquote

app = Flask(__name__)
app.config['JSON_AS_ASCII'] = False

@app.route('/user/<name>')
def get_user(name):
    # 手动解码路由参数，确保是UTF-8编码
    decoded_name = unquote(name, encoding='utf-8')
    return jsonify({"username": decoded_name})

这个方法能覆盖客户端编码不规范的情况，把收到的乱码参数转成正确的Unicode字符串。

3. 检查WSGI服务器的编码配置 #

如果你用的是生产环境的WSGI服务器（比如Gunicorn、uWSGI），要确保服务器的默认编码设置为UTF-8：

• 用Gunicorn的话，启动时加上参数：gunicorn --encoding=utf-8 your_app:app
• 用uWSGI的话，在配置文件里添加：env = LC_ALL=en_US.UTF-8

Flask的开发服务器（Werkzeug）默认是UTF-8编码，但生产服务器可能需要手动指定，避免编码不一致导致解析错误。

为什么硬编码查询字符串正常？ #

因为你在代码里硬编码的字符串是Python的Unicode字符串，Flask直接使用，不需要经过URL解码环节，所以输出正常——这也验证了你的JSON输出配置是没问题的，问题就出在路由参数的URL解码上。

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