Flask树形结构展示的关键是安全序列化与前端防栈溢出：后端需用自定义JSONEncoder限制递归深度并剪枝，禁用ORM自动关联，统一使用字符串ID防精度丢失。
Flask 本身不提供树形组件或递归模板机制，复杂树状结构展示的关键不在后端“怎么存”，而在“怎么安全地序列化”和“前端怎么避免栈溢出渲染”。直接 jsonify 嵌套过深的字典会触发 RecursionError，而前端用纯递归组件展开 10 层以上节点极易卡死。
后端序列化时必须限制递归深度
Flask 的 jsonify 默认不限制嵌套层级，但 Python json 模块有默认递归限制（通常 1000 层），而真实业务树（如组织架构、分类目录）常因环引用或误配置导致无限递归。不能依赖 try/except 捕获 RecursionError —— 它可能发生在 C 层，无法被 Python 异常处理捕获。
- 用自定义 JSONEncoder，重写
default方法，在遍历子节点前检查当前深度，超限时返回占位对象（如{"_truncated": True, "children_count": 12}） - 数据库查询阶段就做层级剪枝：用 CTE（PostgreSQL）或闭包表（Closure Table）预计算路径和深度，SQL 层过滤
depth - 避免在模型中定义
children关系属性自动加载，改用显式方法get_children(max_depth=3)控制递归边界
前端渲染必须用懒加载 + 平铺数据结构
把整个树一次性传给前端再用 v-for 或 {children.map(...)} 递归渲染，是性能灾难的源头。浏览器对调用栈深度敏感，10 层嵌套 + 每层 50 节点，DOM 节点数轻松破万，且无法响应滚动。
- 后端只返回首层节点 + 每个节点带
has_children: bool字段 - 前端点击「展开」时，单独发请求获取该节点的直接子节点（URL 带
parent_id=123），追加到平铺的nodes数组中 - 用
id和parent_id维护关系，渲染时通过filter(n => n.parent_id === currentId)获取子集，而非嵌套对象
避免 ORM 自动关联引发 N+1 和循环引用
SQLAlchemy 的 relationship(backref=...) 或 Django ORM 的 ForeignKey 反向关系，会在序列化时隐式触发子查询或无限展开。更危险的是父子双向引用（A.children → [B]，B.parent → A），JSON 序列化器会陷入死循环。
立即学习“Python免费学习笔记（深入）”；
- 禁用所有
lazy='joined'或lazy='subquery'的树形关系，全部改为lazy='select'并显式控制加载 - 序列化前调用
sqlalchemy.orm.attributes.instance_state(obj).dict获取原始字段值，排除关系属性 - 用 Pydantic v2 的
@computed_field替代模型上的@property，避免意外触发数据库查询
最易被忽略的一点：树节点 ID 类型不一致。后端用 int，前端 JavaScript 当作 number 处理大整数（如 9007199254740992）会丢失精度，导致父子关系错乱。务必统一用字符串 ID，后端生成时就转成 str(id)，前端也按字符串比对。
