导出HTML时数据库连接中断会导致表格无数据但结构完整，需用try/except捕获异常、校验查询结果、模板加空值判断；跨库JOIN应避免应用层拼接，优先用数据库代理或键映射；pandas.to_html()需显式传classes参数并禁用全量渲染；大数据量须分页流式导出或改用异步任务。
导出时数据库连接中断导致 HTML 只有结构没数据
常见现象是生成的 html 文件里表格空空如也，但表头、样式、dom 结构都正常——本质是查询执行失败，但模板渲染没报错。多数框架（如 django 的 render_to_string、flask 的 render_template_string）默认不校验查询结果是否为空，更不会拦截数据库异常。
实操建议：
立即学习“前端免费学习笔记（深入）”；
- 导出前先用
try/except包裹数据查询逻辑，捕获OperationalError、ProgrammingError等典型数据库异常，并提前返回错误提示（比如写入日志 + 返回 500 响应），别让空数据流进模板 - 若用 ORM（如 SQLAlchemy），检查
session.execute()或query.all()是否真的返回了 list；空结果集容易被误判为“成功”，但后续遍历时无内容 - 避免在模板里直接写
{% for row in data %}这类无兜底的循环，加一层{% if data %}...{% else %}<p>暂无数据</p>{% endif %}
跨库 JOIN 查询在 HTML 导出中被静默截断
当需要从 MySQL 和 PostgreSQL 各取一张表拼成报表时，有人会试图在应用层用两个独立查询再手动合并。问题在于：字段顺序错位、重复 ID 冲突、NULL 处理不一致，最终 HTML 表格列对不上、排序乱、点击筛选失效。
实操建议：
立即学习“前端免费学习笔记（深入）”；
- 放弃“应用层拼接”，改用数据库代理层（如
Federated引擎（MySQL）、postgres_fdw（PostgreSQL））或中间件（如pgcat、vitess）做真正跨库 JOIN，确保 SQL 层就输出结构化结果集 - 若必须双查，用唯一键（如
order_id）做字典映射，而不是靠索引位置对齐：postgre_data = {r['id']: r for r in pg_rows}，再遍历 mysql 数据做postgre_data.get(mysql_row['ref_id']) - 导出前打印一行
print(len(mysql_rows), len(pg_rows), len(merged))，数值不等立刻停，别等生成 HTML 才发现少了一半行
to_html() 生成的表格样式丢失且无法复用已有 CSS
pandas 的 to_html() 默认只输出带 class 的表格标签，不带任何内联样式，也不引入外部 <link>；而你写的 Bootstrap 表格样式依赖 .table.table-striped 这类 class，但 pandas 不会自动加这些 class，结果就是白底黑字、无边框、无响应式。
实操建议：
立即学习“前端免费学习笔记（深入）”；
- 用
classes参数显式传入：df.to_html(classes="table table-bordered table-hover")，注意字符串里别加点（.）——classes是纯 class 名列表，不是 CSS 选择器 - 不要依赖
escape=False往单元格里塞 HTML 标签来“修样式”，容易 XSS；真要高亮某列，用formatters参数配函数，返回安全的<span class="highlight">...</span> - 如果导出需嵌入现有页面，把
to_html()结果当片段用，别让它生成完整 HTML（即禁用header=True、index=False，并设table_id="report-table"方便 JS 操作）
导出大表时内存爆掉或超时，HTML 文件只有开头几行
10 万行数据调 to_html() 或拼接模板，Python 进程常在 2GB 内存左右崩掉；Nginx 默认 60 秒超时，导出卡在 70 秒就返回 504，浏览器拿到的是截断的 HTML，打开后表格突然中断、JS 报错。
实操建议：
立即学习“前端免费学习笔记（深入）”；
- 分页导出：用
pd.read_sql(..., chunksize=5000)流式读，每 chunk 调一次to_html()并write(..., mode='a')追加到文件，避免全量加载 - 关掉 pandas 的
notebook渲染优化（max_rows、max_cols）——这些只影响 Jupyter 显示，导出时无效，反而干扰判断 - Web 场景下，别用同步请求导出大表；改成任务队列（
celery+redis），前端轮询下载链接，后端用zipfile打包 HTML + 静态资源，避免长连接阻塞
跨库跨表导出 HTML 最容易被忽略的，其实是事务边界和字符编码一致性——MySQL 用 utf8mb4，PostgreSQL 用 UTF8，但 Python 读出来都是 str，一旦某张表存了 emoji 或生僻字，导出 HTML 后浏览器解码就乱码，还查不出错在哪。
