优化农业营商环境

网站优惠券领取失败，提示 “已达领取上限”

1. 检查优惠券领取限制配置（如每人限领 1 张、总量有限）；2. 核实用户是否已领取该优惠券，避免重复领取；3. 修复领取数量统计逻辑，确保计数准确；4. 明确提示领取上限及用户当前领取次数

网站 API 网关路由失败

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

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

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

网站分页控件 “首页”“尾页” 点击后跳转错误

1. 检查首页 / 尾页的跳转逻辑，是否正确设置页码为 1 或总页数；2. 修复总页数计算，确保尾页页码准确；3. 核实是否存在分页参数传递错误，导致跳转 URL 拼接异常；4. 测试单独点击首页 / 尾页，排查与其他页码的冲突

网站后台插件无法启用

1. 检查插件是否与网站程序版本兼容；2. 核实插件文件权限，是否有执行权限；3. 修复插件启用逻辑，避免配置错误；4. 查看插件日志，排查启用失败原因

网站在平板设备上布局错乱

1. 优化响应式布局，添加平板设备媒体查询（768px-1024px）；2. 调整元素尺寸和间距，适配平板屏幕；3. 确保触摸目标尺寸足够（不小于 48px）；4. 测试横屏 / 竖屏切换，布局自动调整

网站地图标注位置错误

1. 检查地图标注的经纬度是否正确，无输入错误；2. 修复标注位置调整逻辑，允许手动拖动标注；3. 核实地图缩放级别是否合适，标注是否在可视范围内；4. 更换地图数据源，确保地理位置匹配准确

网站音频无法自动播放，即使添加 autoplay 属性

1. 检查浏览器是否支持自动播放，部分浏览器要求静音自动播放（添加 muted 属性）；2. 修复自动播放触发逻辑，确保在用户交互后执行（如页面加载完成后）；3. 核实音频文件是否加载完成，未加载完成无法自动播放；4. 提供手动播放按钮，作为自动播放的备选

网站数据库查询缓慢

1. 对高频查询字段建立索引，优化 SQL 语句（避免 SELECT *）；2. 减少嵌套查询和不必要的联表操作；3. 调整数据库连接数和缓存大小配置；4. 采用数据库读写分离，减轻主库压力