优化课堂教学实践方案

Web 服务器配置文件错误导致服务无法启动

1. 检查配置文件语法（Nginx 用 nginx -t，Apache 用 apachectl configtest）；2. 核实虚拟主机配置中的端口、根目录、日志路径是否正确；3. 注释新增配置，逐步排查错误配置项；4. 恢复之前的正确配置文件，重新启动服务

网站 Word 文件在线预览格式错乱

1. 检查 Docx.js 等预览插件是否正确加载；2. 修复 Word 文件格式解析逻辑，支持复杂格式；3. 确保图片、表格等元素正确显示；4. 处理大文件预览卡顿问题，分页加载

网站商品筛选条件选择后无筛选结果

1. 检查筛选参数传递逻辑，是否正确拼接筛选条件（如价格区间、分类）；2. 修复筛选查询语句，确保多条件组合筛选生效；3. 核实筛选字段是否存在数据（如选择 “红色” 但无红色商品）；4. 无结果时显示友好提示，推荐相似商品

网站表单提交后跳转页面 404

1. 检查跳转 URL 是否正确，无拼写错误、路径错误；2. 核实跳转页面是否存在，未被删除或移动；3. 修复表单提交后的跳转逻辑，确保 URL 拼接正确；4. 配置 301 重定向，将无效 URL 指向正确页面

网站管理员无法修改用户权限

1. 检查权限修改接口是否正常；2. 核实用户权限数据库表是否正确更新；3. 修复权限等级判断逻辑；4. 测试修改后权限是否生效，功能是否正常

网站 WebSocket 消息发送失败

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

网站消息队列（MQ）无法发送消息

1. 检查 MQ 服务（如 RabbitMQ、Kafka）是否正常启动；2. 核实队列是否创建成功，权限是否足够；3. 修复消息发送逻辑，确保参数正确；4. 查看 MQ 日志，排查错误原因

网站导出 CSV 文件打开乱码

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