SHUHARI 的博客

Flask 框架提供了蓝图（Blueprint）的概念，作为划分大型网站的主要工具。但对于地址较为复杂的网站，仅靠 Blueprint 仍然是不够的。以个人博客为例，如果我们把它规划为个人网站的一个子分区，那么很自然地会设置一个 url_prefix='/blog' 的蓝图。但 blog 下面可能不只是一个简单的平面结构，还会有更多的层次，类似这样：

信号（Signal）是 Flask 中一个比较鲜为人知的功能，在官方文档中也对此着墨不多。的确，Signal 并不是 Flask 的核心功能————你完全可以在不使用 Signal 的前提下写出完整的 Flask 应用。但在某些场景下，使用 Signal 有助于避免代码中不必要的耦合，提高可维护性；并且，部分工程化实践，比如针对特定逻辑进行的测试，需要借助 Signal 的帮助才能完成（后面我们会看到一个具体的例子）。因此，本文将帮助你了解什么是 Signal，它的原理、使用方法，以及它在 Flask 中有哪些实际应用。

我们都知道，测试是有层次的。一般来说，测试的组织应该形成类似下图那样金字塔型的结构：在底层有数量很大、短小而快速的单元测试，在开发过程中提供实时反馈；中间层是集成测试，验证各个组件组合在一起是否正常工作；再往上则有所分化，依照不同的侧重点与表现形式、有系统测试、UI 测试、用户验收测试（UAT）、接口测试、端到端测试等多种不同的称呼。从自底向上的角度看，它们应该在数量上逐层递减，但测试覆盖的范围则更大（相应的执行速度也会变慢），在损失代码局部细节的同时，也获得了更广泛的全局视角。

在 Flask 中，蓝图（Blueprint）通常是基于路径进行分派的，因此我们看到典型的注册代码一般类似这样：

app.register_blueprint(home_bp, url_prefix='...')

相对少见的另一种用法是，Blueprint 也可以通过子域名来分派，这涉及到程序结构上会有一些改变，同时也会带来一些新的问题（当然都是可以解决的）。使用子域名是大型网站的常规做法，同时也使得 URL 路径更有针对性，比如提供一个 https://api.mydomain.com/... 比起所有页面都堆到 https://mydomain.com/ 下面，看上去也显得更专业一些。我自己也在尝试通过这种方式重构自己的网站，最开始尝试的是每个域名使用一个单独的 app 去管理，但很快发现如果一些比较小的功能也做成独立的网站，会带来比较多额外的管理负担。因此，把这些功能合并到一个app，对外又能通过子域名公开，是不错的做法。因此，我对这种实现做了一些尝试，并对遇到的问题和解决办法做一个记录，以供自己和其他朋友参考。

在 上一篇文章 我说过示例程序中的 Blueprint 存在设计问题，即 Blueprint 和视图函数存在着循环引用。

Flask 是著名的 Python Web 微框架，而 《Flask Web 开发——基于 Python 的 Web 应用开发实战》（OReilly出版社出品，以一只大狗作为封面，所以也有人戏称“狗书”）则是这一框架的经典书籍。特别是该书的第七章，描述如何将网站划分为多个模块，很多 Flask 网站都是参照该例子的形式进行规划的。

我的 个人主页 也用了 Flask 框架来开发，网站结构在很大程度上参考了该书的示例。但在开发过程中，我也感觉到该方式也有一些不够合理的地方，主要表现在：