解决 Flask 蓝图 (Blueprint) 注册错误：“The setup method ‘route‘ can no longer be called on the blueprint”

在 Flask 应用开发中，我们经常会使用**蓝图（Blueprint）**来模块化我们的应用，将不同的功能模块划分开来，便于维护和扩展。然而，在使用蓝图时，偶尔会遇到一些常见的错误，例如：

AssertionError: The setup method 'route' can no longer be called on the blueprint 'api'. It has already been registered at least once, any changes will not be applied consistently.
Make sure all imports, decorators, functions, etc. needed to set up the blueprint are done before registering it.

这篇博客将详细介绍这个错误产生的原因、如何避免它，以及如何正确使用 Flask 蓝图。

一、问题背景

在 Flask 中，蓝图（Blueprint）提供了一种组织应用程序的方式，特别适合大型项目的模块化管理。我们通常会先定义蓝图，然后将相关的路由、视图、错误处理函数等都绑定到该蓝图上，最后将蓝图注册到 Flask 应用。

一个标准的蓝图定义和注册通常如下所示：