Flask根路径传递GET参数时返回404的问题及解决

首先咱们先聚焦最可能的核心原因：

核心触发点：分页页码超出范围导致404 #

你遇到的这个问题大概率是 Flask-SQLAlchemy的paginate()方法默认行为导致的。当你调用paginate()时，它默认开启了error_out=True参数——如果请求的page数值大于实际存在的总页数（比如你的博客总共只有1页内容，但你请求了page=2），或者页码小于1，这个方法会自动抛出404错误，让你误以为是路由匹配失败。

另外还有个小概率情况：如果page参数传入的是非数字内容（比如?page=abc），你的代码里直接int(request.args.get('page',1))会抛出ValueError，但这种情况通常会返回500错误，而非404，所以你的情况应该不是这个，但还是建议顺手处理一下类型安全问题。

具体解决方法 #

方法1：关闭paginate的自动404报错 #

调用paginate()时手动设置error_out=False，这样即使页码超出范围，也只会返回一个空的分页对象，不会直接抛出404。你可以在视图里自己处理空数据的展示逻辑：

from flask import request, render_template
from flaskblog import app
from flaskblog.models import Post

@app.route('/')
def blog_index():
    # 先处理page参数的类型安全，避免非数字参数报错
    try:
        page_num = int(request.args.get('page', 1))
        page_num = max(page_num, 1)  # 确保页码不小于1
    except ValueError:
        page_num = 1
    
    # 设置error_out=False，避免超出页码时返回404
    post_data = Post.query.order_by(Post.date_posted.desc()).paginate(
        page=page_num, 
        per_page=5,  # 这里改成你每页想显示的文章数
        error_out=False
    )
    return render_template('index.html', posts=post_data.items, pagination=post_data)

方法2：提前校验页码，重定向到有效页码 #

如果你希望用户始终访问有效的页码，可以先计算总页数，然后判断请求的页码是否在合法范围内，超出的话重定向到第一页或者最后一页：

from flask import request, render_template, redirect, url_for
from flaskblog import app
from flaskblog.models import Post

@app.route('/')
def blog_index():
    per_page = 5  # 每页文章数
    try:
        page_num = int(request.args.get('page', 1))
        page_num = max(page_num, 1)
    except ValueError:
        page_num = 1
    
    # 计算总页数
    total_posts = Post.query.count()
    total_pages = total_posts // per_page + (1 if total_posts % per_page != 0 else 0)
    
    # 如果没有文章，强制设置总页数为1
    if total_pages == 0:
        total_pages = 1
    
    # 页码超出范围则重定向
    if page_num > total_pages:
        return redirect(url_for('blog_index', page=total_pages))
    elif page_num < 1:
        return redirect(url_for('blog_index', page=1))
    
    post_data = Post.query.order_by(Post.date_posted.desc()).paginate(
        page=page_num, 
        per_page=per_page
    )
    return render_template('index.html', posts=post_data.items, pagination=post_data)

额外排查点：路由冲突 #

虽然概率极低，但你可以检查一下项目里有没有其他路由和根路由/冲突（比如有没有定义@app.route('/<something>')这种可能意外匹配的路由？不过Flask的路由匹配会忽略查询参数，所以这种情况几乎不会发生）。如果前面的方法都没用，可以顺手排查一下这一点。

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