中建工程项目设计优化案例手册

网站视频全屏播放后无法退出全屏

1. 检查全屏事件监听，是否正确绑定退出全屏按钮；2. 修复全屏 API 调用，兼容不同浏览器（如 webkitCancelFullScreen、exitFullscreen）；3. 核实是否有脚本错误导致全屏状态无法切换；4. 提供快捷键退出全屏（如 Esc 键）提示

网站第三方支付接口调用失败

1. 检查支付平台配置（商户号、API 密钥）是否正确；2. 核实支付参数是否完整，格式是否正确；3. 修复支付签名生成逻辑；4. 查看支付平台回调日志，排查错误

网站离线页面无法显示

1. 检查 Service Worker 是否缓存离线页面；2. 修复离线页面路径配置，确保正确加载；3. 确保离线页面资源完整（CSS/JS/ 图片）；4. 测试离线状态下的页面展示，优化用户体验

网站复选框选中状态在刷新页面后丢失

1. 检查选中状态是否存储（如 localStorage、cookie），无持久化；2. 修复页面加载时的状态回显逻辑，从存储中读取并设置；3. 核实是否存在刷新页面时的表单重置代码；4. 启用表单自动保存功能，实时存储选中状态

网站图表 tooltip 显示不全，内容被截断

1. 检查 tooltip 的样式配置，调整 width、height 属性；2. 修复 tooltip 的 overflow 属性，设置为 auto 允许滚动；3. 核实 tooltip 内容是否过长，简化显示信息；4. 调整图表的边距，给 tooltip 预留足够显示空间

网站大数据量表格渲染卡顿

1. 采用虚拟滚动技术，只渲染可视区域数据；2. 分页加载表格数据，避免一次性渲染过多行；3. 减少表格中的复杂组件（如图片、下拉框），优化 DOM 结构；4. 禁用表格的 hover 效果或复杂动画，提升性能

网站 Excel 文件在线预览数据错误

1. 检查 Excel 预览插件是否正确解析数据；2. 修复表格格式、公式解析逻辑；3. 确保合并单元格、冻结窗格正确显示；4. 处理大数据量 Excel 预览，优化性能

网站后台管理系统权限分配后无效果

1. 检查权限分配逻辑，是否正确关联角色与菜单 / 操作；2. 修复权限校验接口，确保操作时实时校验权限；3. 核实用户是否已关联正确角色，无角色分配错误；4. 刷新权限缓存，处理权限更新延迟场景

网站图片预览功能失效

1. 检查预览插件是否正确加载；2. 核实图片路径是否正确，文件是否存在；3. 修复预览事件监听逻辑（如点击图片）；4. 测试不同图片格式，确保兼容