系统优化原则

网站用户历史记录无法查看

1. 检查历史记录存储逻辑，是否正确记录用户操作；2. 核实历史记录查询接口是否正常；3. 修复历史记录分页加载逻辑；4. 处理历史记录过多的情况，分页显示

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

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

网站问卷调查选项无法多选

1. 检查问卷选项配置，是否设置为多选类型（如 checkbox）；2. 修复表单提交逻辑，确保多选值正确序列化；3. 核实选项是否有最多选择数量限制，无超限；4. 调整选项样式，明确提示是否支持多选

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

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

网站音频播放时进度条无法拖动

1. 检查音频播放器插件是否支持进度条拖动功能；2. 修复进度条事件监听，确保拖动时更新播放位置；3. 核实音频文件是否支持 seek 操作（如部分流媒体不支持）；4. 更换兼容性更好的音频播放器插件

网站表单多文件上传失败

1. 检查上传接口是否支持多文件，参数是否正确；2. 核实文件总大小是否超过限制；3. 修复文件选择逻辑，允许选择多个文件；4. 处理部分文件上传失败的情况，提示用户

网站下拉刷新后数据重复加载

1. 检查下拉刷新的请求参数（如页码）是否正确重置（如刷新后从第 1 页重新加载）；2. 修复数据合并逻辑，避免重复添加已有数据；3. 核实下拉刷新后的状态更新，确保加载状态正确重置；4. 清空原有数据后再加载新数据，避免重复

Apache 服务器响应缓慢，请求堆积

1. 调整最大请求数上限（Apache2.2 用 MaxClients，Apache2.4 用 MaxRequestWorkers）；2. 优化 Apache 进程分配策略，减少空闲进程占用资源；3. 检查是否有慢查询或耗时代码拖慢响应；4. 考虑切换为 Nginx 作为反向代理提升并发能力

网站语音识别无响应，无法识别语音

1. 检查麦克风权限是否开启，浏览器是否有权访问麦克风；2. 修复语音识别接口调用，确保 API 密钥有效；3. 核实录音环境是否安静，无过多背景噪音；4. 测试语音识别接口单独调用是否正常，排查前端集成问题