系统结构优化的方法

网站用户头像上传后不显示

1. 检查头像上传路径是否正确，文件是否保存成功；2. 核实页面头像加载路径是否正确；3. 修复头像裁剪逻辑，确保图片格式 / 尺寸符合要求；4. 清除浏览器缓存，测试最新头像

网站 301 重定向配置后未生效

1. 检查重定向规则语法是否正确（如 Nginx 的 rewrite 指令）；2. 核实重定向源 URL 和目标 URL 是否正确，无循环重定向；3. 处理 HTTPS 环境下的重定向，确保协议一致；4. 清除浏览器缓存，重新测试重定向效果

网站模态框打开后背景滚动无法禁止

1. 打开模态框时给 body 添加 overflow: hidden 样式；2. 修复移动端触摸事件，禁止背景滚动；3. 确保模态框关闭时移除禁止滚动样式；4. 处理 iOS 系统的弹性滚动问题，添加额外兼容代码

网站后台批量操作（如批量删除）执行失败

1. 检查批量操作接口是否支持批量 ID 参数（如数组格式）；2. 修复权限校验逻辑，确保用户有批量操作权限；3. 处理批量操作中的异常数据，避免单个数据失败导致整体中断；4. 显示批量操作结果详情（如成功多少条、失败多少条）

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

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

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

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

网站翻译功能返回结果与原文无关

1. 检查翻译接口的源语言和目标语言参数是否设置错误；2. 修复输入文本传递逻辑，确保原文完整传入接口；3. 核实翻译 API 是否支持当前文本类型（如长文本、专业术语）；4. 更换翻译接口，对比结果排查问题

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

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

网站微信分享功能无法自定义标题 / 图片

1. 检查微信 JSSDK 配置是否正确（appId、timestamp、nonceStr、signature）；2. 核实分享接口（onMenuShareAppMessage 等）是否正确注册；3. 确保分享的图片尺寸符合要求（建议 300x300px）；4. 排查页面是否有脚本错误，导致 JSSDK 初始化失败