优化设计指导思想和理念

网站数据库连接超时或连接池耗尽

1. 检查数据库连接池配置（如最大连接数、超时时间）；2. 修复代码中的连接释放逻辑，避免未关闭连接导致泄漏；3. 优化数据库查询效率，减少连接占用时间；4. 监控数据库连接状态，及时扩容或排查异常连接

网站 API 接口版本冲突

1. 检查接口版本号是否正确，是否支持目标版本；2. 核实请求头中版本参数是否正确传递；3. 提供接口版本兼容方案，避免强制升级；4. 文档中明确版本差异，指导用户适配

网站视频全屏播放后无法退出全屏

1. 检查全屏事件监听，是否正确绑定退出全屏按钮；2. 修复全屏 API 调用，兼容不同浏览器（如 webkitCancelFullScreen、exitFullscreen）；3. 核实是否有脚本错误导致全屏状态无法切换；4. 提供快捷键退出全屏（如 Esc 键）提示

网站下拉刷新功能异常

1. 检查下拉刷新插件是否正确集成；2. 修复触摸事件监听，确保识别下拉动作；3. 优化刷新逻辑，避免重复请求数据；4. 处理下拉刷新失败的提示，引导用户重试

Java 项目部署后网站无法访问

1. 查看 Tomcat 日志和程序日志，定位空指针 / 内存溢出等异常；2. 确认 Tomcat 服务是否正常启动，端口是否被占用；3. 检查 Java 代码的文件权限，确保有执行权限；4. 核实 JDK 版本与项目是否兼容

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

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

网站邮件发送功能失效，无法发送验证码

1. 检查邮件服务器配置（SMTP 地址、端口、账号）；2. 核实邮件发送接口是否正常，是否被封禁；3. 修复邮件内容格式，避免被标记为垃圾邮件；4. 测试不同邮件地址，排查接收方问题

网站第三方登录授权页面提示 “应用未审核”

1. 检查第三方平台（微信 / QQ）的应用审核状态，完成未审核流程；2. 核实应用的经营范围、回调地址是否与审核信息一致；3. 修复应用配置中的错误参数（如 APPID、APPSecret）；4. 测试沙箱环境授权是否正常，排查正式环境配置问题

网站后台数据统计图表无法显示

1. 检查图表生成接口是否正常，是否返回数据；2. 核实图表渲染插件（如 ECharts）是否正确加载；3. 修复数据统计逻辑，确保数据准确；4. 测试不同浏览器，排查兼容性问题