工程项目设计优化

网站微信分享时缩略图不显示

1. 检查分享图片是否符合微信要求（尺寸≥300x300px，格式 jpg/png）；2. 修复微信 JSSDK 的 imgUrl 参数，确保图片路径可访问（公网地址）；3. 核实页面是否存在多张图片，微信未正确识别首图；4. 手动指定分享缩略图，避免微信自动抓取失败

网站 API 网关路由失败

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

网站数据库查询缓慢，导致页面加载卡顿

1. 检查查询语句是否优化，是否添加必要索引；2. 修复查询逻辑，避免全表扫描、多表关联无索引；3. 启用查询缓存，缓存高频查询结果；4. 分库分表或数据分页，减少单次查询数据量

网站 HTTPS 部署后浏览器提示 “证书风险”

1. 检查 SSL 证书是否过期、吊销，重新申请有效证书；2. 核实证书是否包含当前域名，无域名不匹配；3. 修复证书链配置，确保中间证书完整；4. 清除浏览器证书缓存，重新加载页面

网站第三方登录功能失效（微信 / QQ）

1. 检查第三方登录配置（AppID、AppSecret）是否正确；2. 核实回调地址是否与配置一致；3. 修复授权流程，确保步骤正确；4. 查看第三方平台开发者日志，排查错误

网站导航栏下拉菜单点击后无响应（移动端）

1. 检查下拉菜单的点击事件绑定，是否支持移动端触摸事件（touchstart）；2. 修复菜单展开 / 折叠逻辑，确保点击后状态切换；3. 核实菜单是否被其他元素遮挡，导致点击无效；4. 优化移动端导航栏，采用汉堡菜单样式提升交互性

网站时间选择器无法选择 24 点以后的时间

1. 检查时间选择器的时间范围配置，是否限制了最大时间；2. 修复时间格式处理，24 点应转换为次日 0 点或特殊处理；3. 核实是否存在业务逻辑限制，不允许 24 点后操作；4. 调整时间选择器的显示格式，明确时间范围

网站下拉刷新后数据重复加载

1. 检查下拉刷新的请求参数（如页码）是否正确重置（如刷新后从第 1 页重新加载）；2. 修复数据合并逻辑，避免重复添加已有数据；3. 核实下拉刷新后的状态更新，确保加载状态正确重置；4. 清空原有数据后再加载新数据，避免重复

网站地图定位功能不准确

1. 检查定位接口（如高德 / 百度地图 API）配置是否正确；2. 核实 IP 定位是否开启，精度是否足够；3. 提供手动调整定位的功能；4. 处理定位失败的情况，显示默认位置