# 路由修复说明

## 🐛 问题描述

访问 `http://selenwoo.test/admin/news/scraper` 出现 404 错误。

## 🔍 问题原因

Laravel 路由匹配是从上到下的，当 `admin/news/{id}` 在 `admin/news/scraper` 之前定义时，`scraper` 会被当作 `{id}` 参数处理，导致路由无法正确匹配。

## ✅ 解决方案

将静态路由（`/scraper`、`/scrape`、`/history`）放在动态路由（`/{id}`）之前。

### 修改前
```php
Route::prefix('news')->name('news.')->group(function () {
    Route::get('/', [NewsController::class, 'index'])->name('index');
    Route::get('/create', [NewsController::class, 'create'])->name('create');
    Route::post('/', [NewsController::class, 'store'])->name('store');
    Route::get('/{id}', [NewsController::class, 'edit'])->name('edit');  // ← 动态路由在前
    // ...
    Route::get('/scraper', [NewsScraperController::class, 'index'])->name('scraper');  // ← 静态路由在后
});
```

### 修改后
```php
Route::prefix('news')->name('news.')->group(function () {
    Route::get('/', [NewsController::class, 'index'])->name('index');
    Route::get('/create', [NewsController::class, 'create'])->name('create');
    Route::post('/', [NewsController::class, 'store'])->name('store');

    // 新闻采集（必须在动态路由之前）
    Route::get('/scraper', [NewsScraperController::class, 'index'])->name('scraper');  // ← 静态路由在前
    Route::post('/scrape', [NewsScraperController::class, 'scrape'])->name('scrape');
    Route::get('/history', [NewsScraperController::class, 'history'])->name('history');

    // 动态路由
    Route::get('/{id}', [NewsController::class, 'edit'])->name('edit');  // ← 动态路由在后
    // ...
});
```

## 🧪 测试结果

### 路由列表
```
GET|HEAD  admin/news/scraper  →  Admin\NewsScraperController@index
POST      admin/news/scrape   →  Admin\NewsScraperController@scrape
GET|HEAD  admin/news/{id}     →  Admin\NewsController@edit
```

### 测试脚本结果
```
✓ /admin/news/scraper 路由正常
  状态码: 302
```

**说明**: 302 状态码表示重定向到登录页面，这是因为：
1. 路由正常工作
2. 需要管理员权限（IsAdmin 中间件）
3. 未登录用户被重定向到登录页

## 🔐 访问要求

### 必需条件
1. ✅ 已登录系统
2. ✅ 用户具有管理员权限（`is_admin = true`）

### 访问步骤
1. 登录后台：`http://selenwoo.test/login`
2. 使用管理员账号登录
3. 访问采集页面：`http://selenwoo.test/admin/news/scraper`

### 验证管理员账号
```php
// 运行此脚本检查管理员账号
require __DIR__ . '/vendor/autoload.php';
$app = require __DIR__ . '/bootstrap/app.php';
$app->make('Illuminate\Contracts\Console\Kernel')->bootstrap();

$admins = App\Models\User::where('is_admin', true)->get();
echo "管理员账号列表:\n";
foreach ($admins as $admin) {
    echo "- ID: {$admin->id}, 邮箱: {$admin->email}, 姓名: {$admin->name}\n";
}
```

## 📝 常见问题

### Q1: 访问后跳转到登录页面
**A**: 这是正常的，说明路由工作正常。请先登录管理员账号。

### Q2: 登录后还是 404
**A**: 检查以下几点：
1. 确认路由缓存已清除：`php artisan route:clear`
2. 确认用户是管理员：`is_admin = true`
3. 确认 URL 正确：`/admin/news/scraper`

### Q3: 如何创建管理员账号
```bash
# 使用 tinker 创建管理员
php artisan tinker

# 在 tinker 中执行
$user = new App\Models\User();
$user->name = '管理员';
$user->email = 'admin@example.com';
$user->password = bcrypt('password');
$user->is_admin = true;
$user->save();
```

## 🚀 快速测试

### 方法1: 使用测试脚本
```bash
php test_scraper_route.php
```

### 方法2: 直接访问（需登录）
```
http://selenwoo.test/admin/news/scraper
```

### 方法3: 通过后台菜单
```
登录后台 → 左侧菜单 → 🔄 新闻采集
```

## 📊 路由优先级

Laravel 路由匹配规则：
1. 从上到下依次匹配
2. 静态路由优先于动态路由
3. 第一个匹配的路由会被执行

**正确顺序示例**：
```php
// ✓ 正确
Route::get('/users/create', ...);  // 静态路由在前
Route::get('/users/{id}', ...);    // 动态路由在后

// ✗ 错误
Route::get('/users/{id}', ...);    // 动态路由在前
Route::get('/users/create', ...);  // 静态路由在后（会被当作 id = 'create'）
```

## ✅ 修复完成

- ✅ 路由顺序已修正
- ✅ 路由缓存已清除
- ✅ 测试脚本已验证
- ✅ 文档已更新

**当前状态**: 🟢 路由配置正确，可以正常访问（需登录管理员账号）

---

**修复时间**: 2024-02-07
**修复文件**: `routes/admin.php`
**测试状态**: ✅ 通过