Flask-Login模板无法渲染静态图片（302重定向问题）

核心原因 #

Flask-Login的权限验证拦截了静态资源请求，导致访问/static下的图片时触发302重定向到登录页，而登录页本身正在请求该资源，形成无响应的循环重定向。

具体解决步骤 #

1. 让静态资源路由跳过登录验证 #

Flask默认的静态资源路由是/static/<path:filename>，需要给这个路由添加豁免，避免被login_required拦截：

from flask_login import LoginManager

login_manager = LoginManager()
login_manager.init_app(app)

# 获取Flask默认的静态视图函数，标记为无需登录验证
static_view = app.view_functions['static']
login_manager.exempt(static_view)

或者自定义未授权处理逻辑，判断请求路径是否属于静态资源：

from flask import request, redirect, url_for

@login_manager.unauthorized_handler
def unauthorized():
    # 如果请求的是静态资源，直接放行
    if request.path.startswith('/static/'):
        return app.send_static_file(request.path[len('/static/'):])
    # 其他未授权请求重定向到登录页
    return redirect(url_for('login'))

2. 检查登录页的图片引用路径 #

确保登录页中图片使用绝对路径引用，避免相对路径导致的路径解析错误：

<!-- 正确写法 -->
<img src="/static/your-image.png" alt="Logo">

<!-- 避免相对路径，比如： -->
<!-- <img src="../static/your-image.png"> -->

3. 验证静态文件夹配置 #

确认Flask app的静态文件夹配置正确，默认是项目根目录下的static文件夹，如果自定义了路径，要确保路径存在且配置正确：

# 默认配置（无需手动设置）
app = Flask(__name__)

# 如果自定义静态文件夹路径
app = Flask(__name__, static_folder='custom_static', static_url_path='/static')

4. 确保登录页路由未被@login_required装饰 #

登录页本身必须允许未登录用户访问，所以不能给登录路由添加@login_required装饰器：

# 正确示例
@app.route('/login')
def login():
    # 登录页逻辑
    return render_template('login.html')

# 错误示例（会导致重定向循环）
# @login_required
# @app.route('/login')
# def login():
#     return render_template('login.html')

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