系统优化原则技术

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

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

网站微信分享后好友打开显示空白页

1. 检查微信 JSSDK 初始化是否成功，无脚本错误；2. 核实分享链接是否包含特殊字符，未进行 URL 编码；3. 修复页面加载逻辑，避免依赖微信不支持的特性（如某些 ES6 语法）；4. 确保分享页面在微信浏览器中可正常访问，无跨域、404 等问题

网站语音合成功能失效

1. 检查语音合成接口是否正常，配置是否正确；2. 核实音频输出设备是否正常；3. 修复合成语音格式设置，确保浏览器支持；4. 处理合成失败的情况，提供文字显示备选

网站图片显示破损，无法正常加载

1. 检查图片路径是否正确，文件是否损坏；2. 核实图片格式是否被浏览器支持（避免特殊格式）；3. 修复图片文件，重新上传到服务器；4. 配置图片备用地址，加载失败时显示默认图片

网站下拉刷新功能触发过于灵敏，轻微滚动即触发

1. 检查下拉刷新的触发阈值（如下拉距离≥50px），适当增大阈值；2. 修复滚动距离计算逻辑，确保准确判断下拉动作；3. 核实是否存在触摸事件误判，将滚动误识别为下拉；4. 添加下拉刷新触发提示，让用户明确操作方式

网站夜间模式切换失效

1. 检查夜间模式 CSS 样式是否正确加载；2. 修复模式切换逻辑，确保存储用户偏好（localStorage）；3. 确保所有页面支持夜间模式，无样式遗漏；4. 测试模式切换动画，提升用户体验

网站大文件下载中断或速度极慢

1. 启用 HTTP 分块传输（Chunked Transfer Encoding）；2. 采用断点续传技术，支持中断后继续下载；3. 利用 CDN 加速大文件分发，减少源站压力；4. 优化服务器磁盘 IO 和网络带宽，提升传输速度

网站 AJAX 请求返回 401 未授权错误

1. 检查用户登录状态是否过期，引导重新登录；2. 核实请求头中的 Token 是否正确传递，未失效；3. 修复后端权限校验逻辑，确保接口权限配置正确；4. 处理 Token 过期后的自动刷新逻辑

网站表单日期选择器无法选择未来日期

1. 检查日期选择器插件的 maxDate 配置，是否限制了可选范围；2. 修复日期范围逻辑，根据业务需求调整未来日期限制；3. 确保日期格式与后端接口要求一致（如 YYYY-MM-DD）；4. 测试不同浏览器，排查插件兼容性问题