优化营商环境小故事

网站 WebSocket 连接建立失败

1. 检查 WebSocket 服务地址是否正确（ws:// 或 wss://）；2. 核实服务器 WebSocket 服务是否正常启动，端口是否开放；3. 处理跨域场景下的 WebSocket 配置，添加允许的 origin；4. 查看浏览器控制台，排查协议不支持或网络错误

网站在线编辑文档保存失败

1. 检查文档保存接口是否正常，权限是否足够；2. 修复文档内容序列化逻辑，确保数据完整；3. 处理并发编辑冲突，添加版本控制；4. 启用自动保存功能，定期备份文档内容

网站图片显示破损，无法正常加载

1. 检查图片路径是否正确，文件是否损坏；2. 核实图片格式是否被浏览器支持（避免特殊格式）；3. 修复图片文件，重新上传到服务器；4. 配置图片备用地址，加载失败时显示默认图片

网站复选框选中后提交，后端未接收到值

1. 检查复选框的 name 属性是否正确，无拼写错误；2. 修复表单序列化逻辑，确保选中的复选框值被正确传递；3. 核实后端接口是否支持数组参数（如 name="hobby []"）；4. 测试单个复选框选中提交，排查多个复选框冲突问题

网站下拉菜单滚动时被页面截断

1. 检查下拉菜单的 z-index 值，确保高于其他元素；2. 修复下拉菜单的 overflow 属性，必要时设置 overflow: auto 允许内部滚动；3. 调整下拉菜单的定位方式（如 absolute→fixed），适应滚动场景；4. 限制下拉菜单最大高度，避免超出视口

网站积分商城商品兑换后无法发货

1. 检查兑换订单生成逻辑，是否正确关联收货地址；2. 修复发货接口，确保物流信息正确录入；3. 核实商品库存是否充足，无缺货导致无法发货；4. 处理发货失败提示，告知用户原因（如地址无效、库存不足）

网站 WebSocket 连接被服务器主动断开

1. 检查服务器 WebSocket 配置的超时时间，适当延长；2. 修复客户端心跳机制，定期发送 ping 消息维持连接；3. 核实服务器资源是否充足，无连接数限制；4. 处理断开后的自动重连逻辑，确保连接恢复

网站在线客服功能无法发起对话

1. 检查客服系统插件是否正确加载，依赖的 JS 是否完整；2. 核实客服是否在线，无离线导致无法接收对话；3. 修复对话发起接口，确保用户信息正确传递；4. 处理网络异常，提供重试入口

网站导出 CSV 文件打开乱码

1. 设置 CSV 文件编码为 GBK 或 UTF-8+BOM；2. 确保字段分隔符正确（逗号）；3. 处理字段中的特殊字符（如逗号、引号）；4. 测试不同文本编辑器 / Excel 打开效果