优化大师使用教程

网站地图搜索地点无结果

1. 检查地图搜索接口是否正常调用，API 密钥是否有效；2. 核实搜索关键词是否正确，无拼写错误；3. 修复搜索范围限制，是否缩小了搜索区域；4. 处理无结果时的提示，推荐附近地点

网站标签功能异常，无法添加 / 删除标签

1. 检查标签操作接口是否正常，权限是否足够；2. 核实标签数据库表是否正确写入 / 删除数据；3. 修复标签名称过滤逻辑，避免特殊字符导致异常；4. 测试标签关联功能，确保与内容正确绑定

网站后台批量导入数据时超时失败

1. 优化导入接口，采用分片导入机制，分批次处理数据；2. 调整服务器超时配置（如 PHP 的 max_execution_time）；3. 修复数据校验逻辑，减少无效数据处理耗时；4. 提供异步导入功能，后台处理后通知用户结果

网站出现 XSS 跨站脚本攻击

1. 转义输出内容，过滤 script、iframe 等危险标签；2. 启用 CSP（内容安全策略），限制脚本加载源；3. 设置 cookie 为 HttpOnly，防止 JS 窃取；4. 定期更新前端框架，修复已知 XSS 漏洞

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

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

网站滑块验证码无法拖动或验证不通过

1. 检查滑块插件是否正确加载，依赖的 JS/CSS 是否完整；2. 修复滑块拖动事件监听，确保坐标计算准确；3. 核实后端校验接口是否正常接收滑块偏移量；4. 处理移动端触摸事件兼容，确保拖动流畅

网站商品详情页规格选择后无法加入购物车

1. 检查规格选择校验逻辑，是否必须选择完整规格（如颜色、尺寸）；2. 修复规格 ID 传递逻辑，确保选中规格正确关联库存；3. 核实所选规格是否有库存，无库存时提示并禁用加入购物车；4. 刷新页面，重新加载规格及库存数据

网站下拉菜单滚动时被页面截断

1. 检查下拉菜单的 z-index 值，确保高于其他元素；2. 修复下拉菜单的 overflow 属性，必要时设置 overflow: auto 允许内部滚动；3. 调整下拉菜单的定位方式（如 absolute→fixed），适应滚动场景；4. 限制下拉菜单最大高度，避免超出视口

网站导出 CSV 文件打开乱码

1. 设置 CSV 文件编码为 GBK 或 UTF-8+BOM；2. 确保字段分隔符正确（逗号）；3. 处理字段中的特殊字符（如逗号、引号）；4. 测试不同文本编辑器 / Excel 打开效果