软件系统优化方案模版

网站 API 网关路由失败

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

网站移动端页面在 iOS Safari 浏览器样式错乱

1. 检查 CSS 属性兼容性，添加 - webkit - 前缀适配 Safari；2. 修复 viewport 标签配置，避免缩放异常（如 width=device-width）；3. 核实是否使用了 Safari 不支持的 CSS 特性（如 backdrop-filter）；4. 测试不同 iOS 版本，针对性修复兼容问题

网站搜索框输入关键词后搜索结果无排序

1. 检查搜索接口是否默认启用排序规则（如按相关性）；2. 修复排序参数传递，确保默认排序方式生效；3. 核实搜索算法是否支持排序，无排序逻辑缺失；4. 提供手动排序选项（如按时间、热度），提升用户体验

网站图片缩放功能失效

1. 检查缩放插件是否正确加载；2. 修复缩放事件逻辑（滚轮 / 点击）；3. 确保图片容器支持缩放，无样式限制；4. 测试不同图片尺寸，确保缩放流畅

网站支付宝支付接口返回 “商户账户异常”

1. 检查支付宝商户账户是否实名认证、未被冻结；2. 核实支付接口配置的商户 ID、密钥是否正确；3. 修复支付金额、订单号等参数格式，符合支付宝规范；4. 联系支付宝商户客服，排查账户权限或配置问题

网站 PWA 功能无法安装，提示不满足条件

1. 确保网站启用 HTTPS；2. 配置 manifest.json 文件，包含必要字段（name、icons、start_url）；3. 实现 Service Worker，支持离线缓存；4. 测试 PWA 兼容性，确保符合浏览器要求

网站音频音量无法调节

1. 检查音量控制组件与音频元素绑定是否正确；2. 修复音量调节逻辑；3. 确保浏览器和系统未静音；4. 测试不同音频格式，排查兼容性

网站单选框组选择后，其他选项仍可选中

1. 检查单选框的 name 属性是否一致（同一组单选框 name 必须相同）；2. 修复单选框事件监听，避免自定义逻辑覆盖默认行为；3. 核实是否误将单选框设置为复选框（type="checkbox"）；4. 优化单选框样式，明确区分选中 / 未选中状态

网站表单自动填充功能失效

1. 检查表单元素 name/id 属性是否正确；2. 确保浏览器自动填充功能已开启；3. 修复表单 autocomplete 属性设置（设为 on）；4. 测试不同浏览器，排查兼容性