优化配置问题

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

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

网站留言板无法回复留言

1. 检查回复接口权限，确保仅管理员可回复；2. 修复回复逻辑，确保回复内容正确关联原留言；3. 核实回复是否需要审核后显示；4. 处理回复提交后的刷新逻辑，实时显示回复内容

网站 API 接口版本冲突

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

网站投票结果显示错乱，票数与实际不符

1. 检查投票结果查询逻辑，是否正确统计各选项票数；2. 修复票数缓存，确保实时更新最新投票结果；3. 核实是否存在恶意刷票导致的票数异常；4. 提供票数重置功能，处理异常场景

网站积分商城积分兑换记录查询不到

1. 检查兑换记录查询接口的时间范围参数是否正确；2. 修复兑换记录存储逻辑，确保记录完整入库；3. 核实用户 ID 与兑换记录的关联是否正确，无匹配错误；4. 调整查询条件（如模糊查询、全量查询），排查筛选条件过严

网站搜索框输入关键词后搜索结果无排序

1. 检查搜索接口是否默认启用排序规则（如按相关性）；2. 修复排序参数传递，确保默认排序方式生效；3. 核实搜索算法是否支持排序，无排序逻辑缺失；4. 提供手动排序选项（如按时间、热度），提升用户体验

网站验证码刷新后无法点击或验证失败

1. 检查验证码图片生成接口是否正常返回新图片；2. 修复刷新按钮的事件绑定，确保触发重新请求；3. 核实验证码存储的 session 是否与当前用户匹配；4. 优化验证码识别难度，避免过度复杂导致用户误输

网站 WebSocket 消息发送失败

1. 检查 WebSocket 连接状态，是否处于 OPEN 状态（readyState=1）；2. 修复消息发送逻辑，避免在连接未建立或已关闭时发送；3. 核实发送的消息格式是否符合服务器要求（如 JSON 格式）；4. 处理发送失败后的重发机制，确保消息可达

网站跨域请求被浏览器拦截（CORS 错误）

1. 后端添加 Access-Control-Allow-Origin 等 CORS 响应头；2. 核实请求方法（GET/POST）和自定义头是否在允许列表中；3. 处理预检请求（OPTIONS），确保服务器正确响应；4. 前端使用代理服务器转发请求，规避跨域限制