系统内部结构的优化

网站离线缓存不生效，无法离线访问

1. 检查 Service Worker 注册是否成功，是否缓存资源；2. 修复缓存策略，确保关键资源被缓存；3. 清除旧的 Service Worker，更新缓存；4. 测试离线状态下的页面加载，确保功能正常

网站问卷调查提交后无法查看结果

1. 检查问卷结果查询权限，是否允许提交者查看；2. 修复结果统计逻辑，确保问卷提交后实时计算结果；3. 核实问卷是否已结束（未结束问卷可能隐藏结果）；4. 处理结果展示的图表渲染，确保数据正确可视化

网站 PWA 应用无法接收推送通知，提示 “权限被拒”

1. 检查用户是否已拒绝通知权限，引导在浏览器设置中重新开启；2. 修复推送权限申请逻辑，确保在用户交互后触发（如点击按钮）；3. 核实浏览器是否支持 Push API（如部分国产浏览器不支持）；4. 提供权限申请引导页面，告知用户开启通知的步骤

网站扫描二维码无法识别

1. 优化二维码生成参数，提高容错级别；2. 确保二维码图片清晰，无模糊或扭曲；3. 增加二维码边框，提升识别率；4. 测试不同扫码工具，确保兼容

网站地图导航路线规划错误

1. 检查地图 API 的起点、终点坐标是否正确；2. 核实路线规划的出行方式（步行 / 驾车 / 公交）设置是否正确；3. 确保地图 API 密钥有效，且已开通路线规划功能；4. 处理无路线时的提示，提供备选方案

网站打印预览显示异常

1. 优化打印 CSS，确保预览样式正确；2. 修复打印预览中图片缺失问题；3. 确保打印预览中内容完整，不被截断；4. 测试不同浏览器打印预览，统一优化

网站搜索框自动补全下拉框被输入法遮挡

1. 检查补全下拉框的 z-index 值，确保高于输入法；2. 修复输入框聚焦后的下拉框位置调整，避免被遮挡；3. 核实输入法是否启用了悬浮模式，调整页面布局避开；4. 优化补全下拉框样式，缩短显示长度适配输入法

网站文件下载时文件名与预期不一致

1. 检查后端响应头的 Content-Disposition 是否正确设置 filename 参数；2. 修复文件名拼接逻辑，避免参数传递错误；3. 核实是否存在文件名重命名规则，导致自动修改；4. 测试不同文件类型的下载，排查特定类型问题

网站搜索框输入关键词后回车无响应

1. 检查搜索框的 keydown 事件监听，是否正确捕捉回车事件（keyCode=13）；2. 修复回车触发的搜索逻辑，确保调用搜索接口；3. 核实搜索框是否绑定了表单提交事件，无阻止默认行为；4. 点击搜索按钮测试，排查是否仅回车事件失效