优化营商环境 项目建设成功不能开业的原因

网站 API 接口版本冲突

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

网站输入框聚焦后键盘遮挡输入框（移动端）

1. 检查输入框所在容器是否设置 scrollIntoView 属性，聚焦后自动上移；2. 修复移动端页面 meta 标签的 viewport 配置，避免缩放影响；3. 调整输入框位置，避免位于页面底部；4. 监听键盘弹出事件，动态调整页面高度

网站 500 页面未自定义，显示错误代码

1. 创建友好的 500 页面，提示用户系统故障；2. 配置 Web 服务器，指定 500 页面；3. 在 500 页面添加联系客服入口，方便用户反馈；4. 记录错误日志，及时排查故障

网站问卷调查选项无法多选

1. 检查问卷选项配置，是否设置为多选类型（如 checkbox）；2. 修复表单提交逻辑，确保多选值正确序列化；3. 核实选项是否有最多选择数量限制，无超限；4. 调整选项样式，明确提示是否支持多选

网站页面滚动时元素错位或抖动

1. 检查 CSS 定位属性（如 position: fixed）是否正确，避免滚动时偏移；2. 修复滚动事件监听逻辑，避免频繁修改 DOM 导致回流；3. 确保元素宽高固定，或使用 flex/grid 布局适配滚动；4. 处理移动端滚动穿透问题，避免弹窗滚动影响背景

网站消息队列消费失败

1. 检查消费者服务是否正常运行；2. 核实消费逻辑是否正确，无业务错误；3. 修复消息重试机制，处理失败消息；4. 监控队列堆积情况，及时扩容

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

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

网站语音识别无响应，无法识别语音

1. 检查麦克风权限是否开启，浏览器是否有权访问麦克风；2. 修复语音识别接口调用，确保 API 密钥有效；3. 核实录音环境是否安静，无过多背景噪音；4. 测试语音识别接口单独调用是否正常，排查前端集成问题

网站表单单选框无法选中

1. 检查单选框 input 元素 name 属性是否相同；2. 修复选中事件逻辑，确保状态正确切换；3. 确保单选框无样式遮挡，可点击；4. 测试不同浏览器，排查兼容性