班级优化大师使用指南大全

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

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

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

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

网站管理员无法导出数据

1. 检查导出接口是否正常，权限是否足够；2. 核实导出文件格式（Excel/CSV）是否正确；3. 修复导出数据查询逻辑，确保数据完整；4. 处理大数据导出超时问题，分批次导出

网站用户消息通知未收到

1. 检查消息发送逻辑，是否正确推送；2. 核实用户消息设置，是否关闭了通知；3. 修复消息存储数据库，确保消息未丢失；4. 提供消息中心，集中展示所有消息

PHP 网站运行报错，无错误日志

1. 开启 php.ini 中的 log_errors 配置，指定错误日志路径；2. 检查 PHP 运行环境是否安装必要的扩展（如 MySQL 扩展）；3. 核实 PHP 文件的权限，确保 Web 服务器用户可执行；4. 用 php -m 命令检查扩展加载情况

网站会员积分兑换商品后积分未扣除

1. 检查积分兑换接口的事务处理，确保兑换成功后积分同步扣除；2. 修复积分扣除逻辑，避免并发场景下的积分超扣 / 漏扣；3. 核实兑换记录是否正确生成，便于后续对账；4. 增加积分变动日志，记录扣除失败原因（如积分不足）

网站音频音量无法调节

1. 检查音量控制组件与音频元素绑定是否正确；2. 修复音量调节逻辑；3. 确保浏览器和系统未静音；4. 测试不同音频格式，排查兼容性

网站面包屑导航显示错误的路径

1. 检查面包屑数据来源是否正确，与当前页面 URL 匹配；2. 修复路径拼接逻辑，确保层级关系准确；3. 核实路由配置中的元信息（meta）是否完整；4. 处理动态路由参数，确保路径参数正确显示

网站第三方统计工具数据不显示

1. 检查统计代码是否正确嵌入，无语法错误；2. 核实统计工具的站点 ID / 配置是否正确；3. 确保统计代码在页面加载完成前执行，无异步阻塞；4. 排查广告拦截插件是否屏蔽了统计域名