Flask变量名重复报错ValueError，如何解决缩略图服务问题？

嘿，我来帮你搞定这个报错！你遇到的问题根源很明确——你的路由规则里重复用了同一个变量名，Flask可搞不清该把哪个URL片段的值传给函数参数，所以直接抛出了这个错误。

先看你写的路由：

@app.route('/site/<site_hash>/<site_hash>_thumb.png')

这里<site_hash>出现了两次，Flask会把每个<variable>都当成独立的参数，同一个名字重复出现的话，它就懵了：到底要把第一个site_hash的值传给函数，还是第二个？于是就报了variable name 'site_hash' used twice的错。

怎么解决？给你两个实用方案： #

方案一：简化路由，内部拼接图片路径

如果你的缩略图命名规则就是{site_hash}_thumb.png（和目录名一致），那完全没必要在路由里重复定义变量，只保留一个site_hash，然后在函数里自己拼接图片路径就行：

import os
from flask import Flask

app = Flask(__name__)

@app.route('/site/<site_hash>/thumb.png')
def serve_img(site_hash):
    # 构造完整的图片路径
    img_path = os.path.join('./sites', site_hash, f"{site_hash}_thumb.png")
    
    # 先检查文件是否存在，避免报错
    if not os.path.exists(img_path):
        return "图片不存在", 404
    
    # 重点：图片是二进制文件，必须用'rb'模式读取
    with open(img_path, 'rb') as f:
        # 返回时设置正确的Content-Type，浏览器才能正常显示图片
        return f.read(), 200, {'Content-Type': 'image/png'}

方案二：保留完整URL结构，用不同变量名区分

如果你希望URL里明确显示{site_hash}_thumb.png这个文件名，可以把文件名部分设为另一个变量，然后在函数里验证它是否符合预期格式，防止非法访问：

import os
from flask import Flask

app = Flask(__name__)

@app.route('/site/<site_hash>/<filename>')
def serve_img(site_hash, filename):
    # 验证文件名是否符合我们的命名规则
    expected_filename = f"{site_hash}_thumb.png"
    if filename != expected_filename:
        return "无效的图片请求", 403
    
    img_path = os.path.join('./sites', site_hash, filename)
    if not os.path.exists(img_path):
        return "图片不存在", 404
    
    with open(img_path, 'rb') as f:
        return f.read(), 200, {'Content-Type': 'image/png'}

额外提醒两个小坑： #

• 读取图片绝对不能用'r'模式！图片是二进制数据，用文本模式读取会导致文件损坏，必须用'rb'模式。
• 返回图片时一定要设置Content-Type: image/png响应头，不然浏览器可能会把图片当成文本显示，出现乱码。

总的来说，这类错误的核心就是路由规则里重复使用了同一个变量名，只要避免变量名重复，或者用不同变量名配合验证，就能轻松解决。

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