系统内部结构优化趋向方法论

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

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

网站导航功能（地图）无法加载

1. 检查地图 API 密钥是否有效，是否绑定域名；2. 核实地图加载脚本是否正确引入；3. 修复地图容器尺寸设置，避免无法显示；4. 查看浏览器控制台，排查 API 报错

网站后台批量导入数据时超时失败

1. 优化导入接口，采用分片导入机制，分批次处理数据；2. 调整服务器超时配置（如 PHP 的 max_execution_time）；3. 修复数据校验逻辑，减少无效数据处理耗时；4. 提供异步导入功能，后台处理后通知用户结果

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

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

网站 API 接口返回错误码

1. 查看接口文档，确认错误码含义；2. 检查请求参数是否正确，格式是否符合要求；3. 修复接口业务逻辑，处理异常情况；4. 优化错误提示，返回详细错误信息

网站加载时出现 “正在等待fonts.googleapis.com”

1. 下载谷歌字体到本地服务器，替代外部加载；2. 使用国内字体库（如思源黑体、阿里普惠体）；3. 配置字体加载超时处理，避免阻塞页面；4. 优先使用系统默认字体，提升加载速度

网站跨域请求携带 cookie 失败

1. 前端 AJAX 请求添加 withCredentials: true 配置；2. 后端响应头添加 Access-Control-Allow-Credentials: true；3. 确保 Access-Control-Allow-Origin 不设置为 *（需指定具体域名）；4. 检查 cookie 的 domain、path 配置是否与请求域名匹配

网站表单提交失败，数据无法保存

1. 检查表单验证逻辑，是否误判合法输入；2. 查看后端日志，排查数据插入数据库时的错误；3. 确保表单提交方式（GET/POST）与后端接口一致；4. 增加表单提交反馈，提示用户提交状态