Flask 返回 404 状态码|极客笔记

Flask 返回 404 状态码

在 Web 开发中，状态码是 HTTP 协议中用来表示服务器响应的特定状态的标识符。其中，404 状态码表示客户端请求的资源未找到。在使用 Flask 开发Web应用时，我们常常需要处理资源未找到的情况并返回 404 状态码给客户端。本文将详细介绍如何在 Flask 中返回 404 状态码。

什么是 Flask

Flask 是一个轻量级的 Web 应用框架，它由 Python 编写而成。Flask 提供了简单而易用的方式来构建 Web 应用，支持路由、模板引擎、请求、响应等功能。通过 Flask，开发者可以快速地搭建 Web 应用，并实现灵活的定制。

返回 404 状态码的情况

在Web开发中，经常会遇到客户端请求的资源不存在的情况。这时，服务器需要向客户端返回 404 状态码，告知客户端请求的资源未找到。常见的情况包括：

用户请求的路由不存在
请求的文件或资源不存在
数据库中没有对应的记录

在这些情况下，我们需要在 Flask 中自定义处理机制，返回适当的 404 状态码给客户端。

Flask 中返回 404 状态码

为了在 Flask 中返回 404 状态码，我们可以使用 abort 函数来中断请求并返回指定的 HTTP 状态码。下面是一个简单的示例代码：

from flask import Flask, abort

app = Flask(__name__)

@app.route('/')
def index():
    # 模拟资源不存在的情况
    abort(404)

if __name__ == '__main__':
    app.run()

在上面的示例中，我们定义了一个路由 /，当客户端请求该路由时，会调用 index 函数。在 index 函数中我们使用 abort(404) 来返回 404 状态码。

运行以上代码，访问 http://127.0.0.1:5000/ 即可看到浏览器返回状态码为 404 的页面。

自定义 404 页面

除了返回 404 状态码外，我们还可以自定义 404 页面，提供更友好的提示给用户。在 Flask 中，可以使用 errorhandler 装饰器来处理指定的 HTTP 状态码。下面是一个示例代码：

from flask import Flask, render_template

app = Flask(__name__)

@app.errorhandler(404)
def page_not_found(error):
    return render_template('404.html'), 404

if __name__ == '__main__':
    app.run()

在上面的示例中，我们定义了一个 page_not_found 函数来处理 404 错误。该函数使用 render_template 函数来加载 404.html 模板，并将 404 状态码作为第二个参数返回。

创建 404 页面模板

在上面的示例中，我们使用了 render_template 函数来加载 404.html 模板。下面是一个简单的 404.html 模板示例：

<!DOCTYPE html>
<html>
<head>
    <title>404 Not Found</title>
</head>
<body>
    <h1>404 Not Found</h1>
    <p>The requested URL was not found on the server. If you entered the URL manually, please check your spelling and try again.</p>
</body>
</html>

以上代码定义了一个基本的 HTML 结构，显示了一条友好的提示信息。