HTML仪表盘无法直连数据库，所有数据库操作必须由后端完成；fetch失败主因是后端未启动、路由错误或跨域配置缺失，需检查Network请求、设置CORS头、处理OPTIONS预检、确保HTTP协议运行；Flask/FastAPI应复用连接池、统一JSON序列化、清洗字段并按语义分组API；前端须等待JSON解析完成、防御性读取数据、统一时间格式，并严格遵循前后端接口契约。
HTML 仪表盘不能直接连接数据库，所有“连上”动作都发生在后端，前端只负责发请求、收 JSON、渲染图表或表格。试图在 index.html 里写数据库连接代码，必然失败。
fetch("/api/metrics") 报 Failed to fetch 或 CORS error 怎么办？
这是最常见卡点：前端调用了接口，但后端没启动、路由不存在，或没配跨域头。
- 检查浏览器开发者工具 Network 标签页，确认请求是否发到了正确地址（比如
/api/metrics），状态码是不是 404 或 502 - 后端必须显式设置响应头，例如 Express 中用
res.header("Access-Control-Allow-Origin", "http://localhost:5173")；开发时可临时用*，但上线前必须限制域名 - 如果用 POST 或带自定义 header（如
Authorization），浏览器会先发OPTIONS预检请求——后端没处理这个路径，就会静默失败。需加app.options("/api/metrics", cors())或手动响应 204 - 确保后端服务已运行，且监听的是 HTTP（不是
file://协议）。双击打开 HTML 文件，fetch会被浏览器直接拦截
Python Flask / FastAPI 怎么返回实时数据库数据给仪表盘？
关键不是“怎么查”，而是“怎么安全、高效、结构化地返回”。后端要承担连接复用、错误封装、类型转换三件事。
Convert Markdown To HTML And PDF - Markdown和HTML、PDF互转
下载
实现 Markdown↔ HTML 互转，支持导出 PDF，用于用户请求的文档格式转换。
- 别每次请求都新建数据库连接：Flask 中用
sqlite3.connect()是可以的，但 PostgreSQL/MySQL 必须用连接池（如psycopg2.pool.ThreadedConnectionPool或asyncpg.Pool），否则并发一高就卡死 - 查询结果必须转成标准 JSON：SQLite 的
datetime、PostgreSQL 的jsonb字段，不处理会报TypeError: Object of type datetime is not JSON serializable。可用json.dumps(data, default=str)或 Pydantic 模型统一序列化 - 别把原始 SQL 结果直接
jsonify()返回：字段名大小写混乱、空值为None、数字精度丢失。建议用字典映射做一次清洗，比如把user_name→userName - 接口路径建议按语义分组：
/api/dashboard/traffic、/api/dashboard/revenue，而不是全塞进一个/api/data
前端用 Chart.js 渲染时，data 总是 undefined 或格式错乱？
问题通常不在图表库，而在你没等 JSON 解析完就调用了渲染函数，或者后端返回的结构和前端预期不一致。
-
fetch("/api/traffic").then(r => r.json()).then(data => chart.update())是正确链路；如果写成.then(data => { chart.data = data; chart.update() })却没校验data.labels和data.datasets是否存在，就会白屏 - 后端返回示例应明确字段：{ "labels": ["Mon", "Tue"], "datasets": [{ "label": "Visits", "data": [120, 190] }] }。前端不要假设字段名，用
data?.labels || []做防御性读取 - 时间类数据最容易出错：后端传 Unix timestamp（数字）或 ISO string（"2026-10-27T08:30:00Z"）都行，但前端解析时得统一。Chart.js 接受
Date对象，别传字符串让库自己猜 - 避免在
fetch外层用var chart声明，然后在回调里赋值——异步执行顺序不可控。改用let chart = null+ 初始化检查，或用async/await包一层
真正难的不是写通一条请求，而是让每条 API 在高并发、字段变更、类型异常时都不崩。后端返回的 JSON 结构一旦定下，前端就要严格按契约消费；反过来，前端传参格式（如时间范围用 start=2026-10-01&end=2026-10-27）也要后端明确支持。两边靠文档对齐，比靠“试试看”可靠得多。
前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
