产品优化方案模板

网站 API 网关路由失败

1. 检查网关服务（如 Spring Cloud Gateway）是否正常运行；2. 核实路由配置是否正确，路径是否匹配；3. 修复网关过滤器逻辑，避免拦截正常请求；4. 查看网关日志，排查错误原因

网站表单输入框输入时自动联想内容错误

1. 检查自动联想功能的数据源是否正确，无错误数据；2. 修复联想匹配逻辑，确保关键词与联想结果相关；3. 核实是否启用了浏览器自带的自动填充，干扰自定义联想；4. 提供联想结果删除功能，清理错误联想内容

网站表单文件上传进度不显示

1. 检查上传进度监听逻辑是否正确；2. 修复进度条渲染，确保百分比准确；3. 确保上传接口支持分片上传，返回进度；4. 测试不同文件大小，确保进度更新流畅

网站 PDF 文件在线预览乱码

1. 确保 PDF 文件编码正确，无损坏；2. 修复 PDF.js 配置，确保字体支持；3. 核实 PDF 文件路径是否正确，无中文乱码；4. 测试不同大小的 PDF 文件，确保预览流畅

网站 CSS 动画在移动端卡顿严重

1. 优化动画属性，优先使用 transform 和 opacity（硬件加速）；2. 减少动画元素数量和复杂程度，避免过度绘制；3. 修复动画帧率，设置 animation-duration 合理值；4. 针对移动端单独优化动画，降低性能消耗

网站导航栏下拉菜单 hover 时无法显示子菜单

1. 检查下拉菜单的 CSS 样式，是否设置了 display: none 且 hover 时未切换；2. 修复 hover 事件绑定，确保鼠标悬浮在父菜单时显示子菜单；3. 核实子菜单的 z-index 值，避免被其他元素遮挡；4. 调整父菜单与子菜单的间距，避免 hover 中断

网站二维码生成后扫描无响应

1. 检查二维码包含的链接是否正确，无拼写错误；2. 修复二维码生成参数，确保容错率、尺寸符合要求；3. 核实链接是否公网可访问，无防火墙拦截；4. 测试不同扫码工具，排查工具兼容性问题

网站音频播放时无声音，进度条正常滚动

1. 检查音频文件是否损坏，测试本地播放是否正常；2. 修复音频播放器的音量设置，避免默认静音；3. 核实浏览器音频权限是否开启，无被禁用；4. 更换音频格式（如 MP3 替代 WAV），排查格式兼容性问题

网站表单单选框无法选中

1. 检查单选框 input 元素 name 属性是否相同；2. 修复选中事件逻辑，确保状态正确切换；3. 确保单选框无样式遮挡，可点击；4. 测试不同浏览器，排查兼容性