task_track/TROUBLESHOOTING.md

🔧 404错误排查指南

当前问题

后端返回404错误，说明 /api/auth/test-login 端点没有正确注册。

解决步骤

1. 停止所有服务

# 在当前命令行窗口按 Ctrl+C 停止服务
# 或者运行：
taskkill /f /im go.exe
taskkill /f /im node.exe

2. 运行诊断工具

diagnose.bat

检查系统环境是否正常。

3. 重新启动系统

start.bat

4. 测试API连接

# 等待系统完全启动后运行：
test-api.bat

5. 手动测试

如果问题仍然存在，请按以下步骤手动测试：

5.1 测试基本连接

浏览器访问: http://localhost:8080/api/test 应该看到API工作状态信息。

5.2 测试登录端点

使用curl或浏览器开发者工具：

curl -X POST http://localhost:8080/api/auth/test-login

6. 常见问题解决

问题A: 端口被占用

# 查看占用8080端口的进程
netstat -ano | findstr :8080
# 杀死进程（替换PID）
taskkill /f /pid [PID]

问题B: 后端编译失败

cd backend
go mod tidy
go build main.go

问题C: 前端无法启动

cd frontend
rm -rf node_modules
npm install

7. 如果问题持续存在

1. 查看后端控制台输出

   • 检查是否有编译错误
   • 查看路由注册信息

2. 检查代码更改

   • 确认 TestLogin 方法已正确添加到 auth.go
   • 确认路由已正确注册在 router.go

3. 手动重启后端

   restart-backend.bat
   

8. 快速验证方案

如果需要快速验证功能，可以暂时跳过登录：

1. 在浏览器localStorage中手动设置token：

   localStorage.setItem('token', 'test-token-123')
   

2. 临时修改中间件跳过token验证

---

💡 提示: 大多数404错误是由于后端服务未完全重启导致的。确保完全停止并重新启动后端服务。