math_cms/题目生成功能故障排除指南.md

✅ 题目生成功能故障排除指南

🔍 问题：后台看不到"生成题目"按钮

可能原因及解决方案

1️⃣ 检查登录状态

症状: 页面显示登录表单或空白页面

解决方案:

# 确保已经登录到Laravel后台
http://fa.test/admin

2️⃣ 检查导航菜单

症状: 左侧导航菜单没有"题库系统"分组

解决方案:

1. 进入后台首页
2. 查看左侧导航菜单
3. 应该能看到 "📦 题库系统" 分组
4. 点击展开，应该能看到 "📚 题库管理" 菜单项

如果看不到"题库系统"分组:

• 检查是否登录了管理员账户
• 清除浏览器缓存并刷新页面

• 清除Laravel缓存：

  php artisan config:clear
  php artisan view:clear
  php artisan filament:clear-cache
  

3️⃣ 检查页面是否可访问

解决方案:

1. 直接访问页面URL：

   http://fa.test/admin/question-management
   

2. 如果看到页面内容，说明页面正常工作

4️⃣ 检查页面头部按钮

症状: 页面加载正常，但头部没有"生成题目"按钮

解决方案:

1. 查看页面顶部操作栏
2. 应该有三个按钮：
   • "管理提示词" (蓝色)
   • "生成题目" (绿色)
   • "刷新" (橙色)

如果按钮不显示:

• 检查浏览器控制台是否有JavaScript错误
• 尝试强制刷新页面 (Ctrl+Shift+R 或 Cmd+Shift+R)

• 检查是否正确构建了前端资源：

  npm run build
  

5️⃣ 测试按钮功能

解决方案:

1. 点击"生成题目"按钮
2. 应该弹出模态框，包含：
   • 知识点选择下拉框
   • 技能选择复选框
   • 题目数量输入框
   • "开始生成"按钮

如果模态框不弹出:

• 检查浏览器控制台错误
• 检查网络请求（开发者工具 > Network）
• 确认题库服务和知识图谱服务正在运行

6️⃣ 检查服务依赖

确保以下服务正在运行：

# 检查题库服务
curl http://localhost:5015/health
# 应该返回: {"status":"ok","service":"question-bank"}

# 检查知识图谱服务
curl http://localhost:5011/health
# 应该返回状态信息

# 检查LearningAnalytics服务
curl http://localhost:5016/health
# 应该返回: {"status":"healthy","service":"LearningAnalytics","version":"1.0.0"}

7️⃣ 重启Laravel开发服务器

如果所有方法都不行，尝试重启：

# 停止当前服务
# (在Herd中，右键 > Stop)

# 重新启动
# (在Herd中，右键 > Start)

8️⃣ 查看日志

# Laravel错误日志
tail -f storage/logs/laravel.log

# Nginx访问日志 (如果使用)
tail -f /var/log/nginx/error.log

📝 完整测试步骤

步骤1: 访问后台

打开浏览器，访问: http://fa.test/admin
使用管理员账户登录

步骤2: 检查导航菜单

左侧菜单 > 查看是否有 "📦 题库系统" 分组
点击分组 > 查看是否有 "📚 题库管理" 菜单项

步骤3: 进入题库管理页面

点击 "📚 题库管理" 菜单项
等待页面加载完成

步骤4: 检查头部按钮

查看页面顶部操作栏
应该显示三个按钮: "管理提示词", "生成题目", "刷新"

步骤5: 测试生成功能

点击 "生成题目" 按钮
应该弹出模态框
在模态框中选择知识点
查看技能列表是否加载
输入题目数量
点击 "开始生成" 按钮

✅ 成功标志

当所有功能正常工作时，您应该能看到：

1. ✅ 后台登录成功
2. ✅ 左侧导航菜单显示"题库系统"分组
3. ✅ 题库管理页面正常加载
4. ✅ 页面顶部显示三个操作按钮
5. ✅ 点击"生成题目"弹出模态框
6. ✅ 模态框中知识点和技能列表正常加载
7. ✅ 可以成功生成题目

🆘 仍然无法解决？

如果按照以上步骤操作后仍然无法看到"生成题目"按钮，请提供以下信息：

1. 登录截图 - 显示是否成功登录
2. 导航菜单截图 - 显示左侧菜单是否显示"题库系统"
3. 页面截图 - 显示题库管理页面的头部按钮
4. 浏览器控制台 - 截图开发者工具的Console和Network标签

5. 服务状态 - 运行以下命令并提供结果：

   curl http://localhost:5015/health
   curl http://localhost:5011/health
   curl http://localhost:5016/health
   

---

最后更新: 2025-11-19 13:45 状态: 待验证