引擎优化指南

网站地图搜索地点无结果

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

网站在线客服消息发送延迟严重

1. 检查 WebSocket 连接是否稳定，优化网络传输（如启用压缩）；2. 修复消息队列处理逻辑，避免消息堆积；3. 核实服务器资源是否充足（CPU / 内存），无过载；4. 提供消息发送状态提示（如 “发送中”“已送达”）

网站管理员无法修改用户权限

1. 检查权限修改接口是否正常；2. 核实用户权限数据库表是否正确更新；3. 修复权限等级判断逻辑；4. 测试修改后权限是否生效，功能是否正常

网站页面打印时格式错乱，部分内容缺失

1. 检查打印样式（print.css）是否配置，是否隐藏不必要元素；2. 修复打印布局，确保内容适应纸张大小（如 A4）；3. 核实打印时的图片、表格是否完整渲染；4. 提供 “打印友好版” 页面，优化打印格式

网站时间选择器只能选择整点，无法选择分钟

1. 检查时间选择器的 stepMinutes 参数是否设置为 60；2. 修复插件初始化配置，调整分钟步长（如 stepMinutes: 5）；3. 核实是否自定义样式隐藏了分钟选择面板；4. 更换时间选择器插件，排查功能限制问题

网站 PWA 应用离线无法访问

1. 检查 Service Worker 是否缓存了核心资源（HTML、CSS、JS、图片）；2. 修复缓存策略，确保关键资源被正确缓存；3. 核实离线页面是否配置正确，可被 Service Worker 拦截返回；4. 清除旧的 Service Worker 缓存，更新为最新版本

网站表单上传文件类型限制失效

1. 前端强化文件类型校验（通过后缀名 + MIME 类型双重验证）；2. 后端严格校验文件头信息，避免篡改后缀名绕过限制；3. 修复 Web 服务器的 upload_filter 配置，启用类型过滤；4. 明确提示支持的文件格式（如 “仅支持 jpg/png/pdf 格式”）

网站 URL 结构复杂，不利于 SEO

1. 简化 URL 结构，使用拼音 / 英文关键词，避免参数过多；2. 采用层级结构（如 /category/article/123.html）；3. 启用伪静态 URL，去除 index.php 等后缀；4. 确保 URL 永久不变，避免频繁修改

网站表单上传文件大小超出限制提示不明确

1. 在前端添加文件大小校验，超过限制时实时提示；2. 配置 Web 服务器的 client_max_body_size 参数（Nginx），明确限制大小；3. 后端返回具体错误信息（如 “文件超过 5MB 限制”）；4. 在表单页面提前标注文件大小限制说明