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

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

### 可能原因及解决方案

## 1️⃣ **检查登录状态**

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

**解决方案**:
```bash
# 确保已经登录到Laravel后台
http://fa.test/admin
```

## 2️⃣ **检查导航菜单**

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

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

**如果看不到"题库系统"分组**:
- 检查是否登录了管理员账户
- 清除浏览器缓存并刷新页面
- 清除Laravel缓存：
  ```bash
  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)
- 检查是否正确构建了前端资源：
  ```bash
  npm run build
  ```

## 5️⃣ **测试按钮功能**

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

**如果模态框不弹出**:
- 检查浏览器控制台错误
- 检查网络请求（开发者工具 > Network）
- 确认题库服务和知识图谱服务正在运行

## 6️⃣ **检查服务依赖**

确保以下服务正在运行：

```bash
# 检查题库服务
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开发服务器**

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

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

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

## 8️⃣ **查看日志**

```bash
# 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. **服务状态** - 运行以下命令并提供结果：
   ```bash
   curl http://localhost:5015/health
   curl http://localhost:5011/health
   curl http://localhost:5016/health
   ```

---

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