自定义Flask装饰器引发UnboundLocalError问题求助

我懂你现在的处境——给开发环境搭模拟服务，参考Flask官方文档写了个校验授权令牌的自定义装饰器，结果碰到了UnboundLocalError，挺闹心的。从你给出的报错栈来看，这个错误在Python嵌套函数（比如装饰器的内部包装函数）里特别常见，本质原因是你在函数内部引用了一个变量，Python默认把它当成局部变量，但在赋值之前就调用了它。

常见错误场景示例 #

这是很多人刚写装饰器时会踩的坑，比如你可能写出了类似下面的代码：

from flask import request, jsonify

def token_required(f):
    def decorated(*args, **kwargs):
        # 先引用了valid_token，之后才赋值
        if not valid_token:
            return jsonify({'message': 'Token missing or invalid'}), 401
        # 这里赋值后，Python会把valid_token认定为decorated函数的局部变量
        valid_token = request.headers.get('Authorization')
        return f(*args, **kwargs)
    return decorated

这段代码里，valid_token在赋值前就被if not valid_token引用了，Python会认为这是个局部变量，但此时它还没被定义，直接触发UnboundLocalError。

针对性解决方案 #

1. 调整变量顺序：先赋值，再校验

这是最直接的修复方式，先获取令牌值，再做校验逻辑，和Flask官方的login_required等装饰器逻辑一致：

from flask import request, jsonify

def token_required(f):
    def decorated(*args, **kwargs):
        # 先获取令牌，赋值给valid_token
        valid_token = request.headers.get('Authorization')
        # 再做校验（替换成你自己的令牌验证逻辑）
        if not valid_token or not your_token_validation_func(valid_token):
            return jsonify({'message': 'Token missing or invalid'}), 401
        # 校验通过后执行原视图函数
        return f(*args, **kwargs)
    return decorated

2. 若需修改外部作用域变量（Python2.7适配）

如果你的装饰器需要修改外层函数的变量（授权校验场景一般不需要），因为你用的是Python2.7，没有nonlocal关键字，可以用可变对象（比如字典）绕开局部变量限制：

def token_required(f):
    # 用字典存外部变量，可变对象可在内部修改
    outer_vars = {'token_valid': False}
    def decorated(*args, **kwargs):
        valid_token = request.headers.get('Authorization')
        outer_vars['token_valid'] = your_token_validation_func(valid_token)
        if not outer_vars['token_valid']:
            return jsonify({'message': 'Token invalid'}), 401
        return f(*args, **kwargs)
    return decorated

不过这个方案在你的授权校验场景里大概率用不上，还是第一种方案更贴合需求。

额外排查点 #

如果调整顺序后还是报错，建议检查：

• 装饰器内部的嵌套函数里，有没有其他变量存在“先引用后赋值”的情况
• 有没有误把全局变量当成局部变量使用（比如在装饰器里直接修改全局变量但没加global声明）

如果能贴出你的装饰器完整代码，能更精准定位问题，但根据常见的Flask装饰器踩坑经验，上面的方案应该能解决你的问题。

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