系统优化的方法哲学原理

网站 OCR 识别功能失效

1. 检查 OCR 接口是否正常，配置是否正确；2. 核实图片是否清晰，符合识别要求；3. 修复图片上传逻辑，确保格式 / 尺寸正确；4. 处理识别错误，提供手动输入备选

网站下拉框选项过多时出现滚动条无法滚动

1. 检查下拉框的 overflow 属性是否设置为 auto，且高度固定；2. 修复滚动事件监听，确保鼠标滚轮或触摸滚动生效；3. 核实下拉框是否被其他元素遮挡，导致滚动事件失效；4. 优化下拉框，启用搜索或分页加载，减少选项数量

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

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

网站表单时间选择器分钟步长设置无效

1. 核实时间选择器的 stepMinutes 参数配置是否正确；2. 修复插件初始化逻辑，确保步长参数正确传递；3. 避免自定义样式覆盖插件默认步长控制；4. 测试不同时间格式（12 小时 / 24 小时制）下的效果

Nginx 作为反向代理时无法转发请求

1. 检查 Nginx 的 proxy_pass 配置是否正确指向后端服务；2. 核实后端服务是否正常运行，端口是否可通；3. 查看 Nginx 错误日志，排查权限或网络问题；4. 调整 proxy_connect_timeout 等超时参数

网站模态框（弹窗）无法关闭或打开多次

1. 检查关闭按钮的事件绑定是否正确，无重复绑定；2. 修复模态框显示状态标识，避免多次打开叠加；3. 确保模态框的 z-index 值足够高，不被其他元素遮挡；4. 处理模态框关闭后的回调函数，重置表单或数据

网站表格合并单元格后排序 / 筛选失效

1. 修复排序 / 筛选算法，确保正确识别合并单元格的数据；2. 避免合并关键数据列，只合并展示性列（如备注）；3. 排序 / 筛选时临时取消合并，排序完成后重新合并；4. 提示用户合并单元格后排序可能影响结果，建议先取消合并

网站分布式锁无法释放

1. 检查锁超时时间设置，避免过长；2. 修复锁释放逻辑，确保业务结束后释放；3. 采用续租机制，防止锁提前过期；4. 定期清理过期锁，避免死锁

网站 API 接口限流触发，无法访问

1. 检查限流配置（如 QPS 阈值）是否合理；2. 优化请求频率，避免频繁调用；3. 申请提高限流阈值，适配业务需求；4. 实现限流降级方案，返回友好提示