Flask 路径规则中的尾部斜杠触发 404
- 2025-04-16 08:57:00
- admin 原创
- 12
问题描述:
我想将 下的任何路径重定向/users
到静态应用。以下视图应该捕获这些路径并提供相应的文件(本例中它仅打印路径)。这适用于/users
、/users/604511
和/users/604511/action
。为什么该路径会/users/
导致 404 错误?
@bp.route('/users')
@bp.route('/users/<path:path>')
def serve_client_app(path=None):
return path
解决方案 1:
您的/users
路由末尾缺少斜杠,Werkzeug 会将其解释为一条显式规则,不匹配末尾的斜杠。您可以添加末尾的斜杠,这样如果 URLstrict_slashes=False
中没有斜杠,Werkzeug 就会重定向;或者,您可以设置路由末尾的斜杠,这样无论是否包含斜杠,Werkzeug 都会匹配该规则。
@app.route('/users/')
@app.route('/users/<path:path>')
def users(path=None):
return str(path)
c = app.test_client()
print(c.get('/users')) # 302 MOVED PERMANENTLY (to /users/)
print(c.get('/users/')) # 200 OK
print(c.get('/users/test')) # 200 OK
@app.route('/users', strict_slashes=False)
@app.route('/users/<path:path>')
def users(path=None):
return str(path)
c = app.test_client()
print(c.get('/users')) # 200 OK
print(c.get('/users/')) # 200 OK
print(c.get('/users/test')) # 200 OK
您还可strict_slashes
以为所有 URL 进行设置。
app.url_map.strict_slashes = False
但是,大多数情况下,你应该避免禁用严格斜杠。文档解释了原因:
此行为允许相对 URL 即使省略尾部斜杠也能继续工作,这与 Apache 和其他服务器的工作方式一致。此外,URL 将保持唯一,这有助于搜索引擎避免对同一页面进行两次索引。
解决方案 2:
要全局禁用严格斜杠,请url_map.strict_slashes = False
按如下方式设置:
app = Flask(__name__)
app.url_map.strict_slashes = False
这样您就不必strict_slashes=False
对每个视图都使用。
然后,您只需定义不带尾部斜杠的路线,如下所示:
bp = Blueprint('api', __name__, url_prefix='/api')
@bp.route('/my-route', methods=['POST'])
然后两者/my-route
的/my-route/
工作方式相同。
解决方案 3:
这是因为 Werkzeug 与其他 HTTP 服务器保持一致。你可以查看 Flask 的快速入门文档。相关段落如下:
唯一 URL / 重定向行为
Flask 的 URL 规则基于 Werkzeug 的路由模块。该模块的理念是基于 Apache 和早期 HTTP 服务器制定的先例,确保 URL 美观且唯一。
采取以下两条规则:
@app.route('/projects/') def projects(): return 'The project page' @app.route('/about') def about(): return 'The about page'
虽然它们看起来很相似,但在 URL 定义中尾部斜杠的使用上有所不同。在第一种情况下,项目端点的规范 URL 尾部有一个斜杠。从这个意义上讲,它类似于文件系统上的文件夹。访问它时如果尾部没有斜杠,Flask 会重定向到带有斜杠的规范 URL。
然而,在第二种情况下,URL 的定义没有尾部斜杠,就像类 UNIX 系统上的文件路径名一样。访问带有尾部斜杠的 URL 将产生 404 “未找到”错误。
此行为允许相对 URL 即使省略尾部斜杠也能继续工作,这与 Apache 和其他服务器的工作方式一致。此外,URL 将保持唯一,这有助于搜索引擎避免对同一页面进行两次索引。
因此也只需将其添加/users/
到路由中。
扫码咨询,免费领取项目管理大礼包!