diff --git a/TROUBLESHOOTING.md b/TROUBLESHOOTING.md deleted file mode 100644 index 1720b6e..0000000 --- a/TROUBLESHOOTING.md +++ /dev/null @@ -1,238 +0,0 @@ -# 考试信息管理系统 - 常见问题修复指南 - -## 🔧 问题：首页显示 "Not Found" - -### 问题描述 -访问系统首页（http://localhost:8080）时显示 "Not Found" 错误。 - -### 原因分析 -1. **前端未构建**：项目缺少 `frontend/dist` 目录 -2. **静态文件服务未配置**：后端无法提供前端页面文件 -3. **SPA 路由未处理**：Vue Router 的前端路由需要特殊配置 - -### 解决方案 - -#### 方法一：使用快速启动脚本（推荐） - -**Windows PowerShell:** -```powershell -.\start.ps1 -``` - -**Windows CMD:** -```batch -start.bat -``` - -脚本会自动： -- ✅ 检查 Go 和 Node.js 环境 -- ✅ 安装前端依赖 -- ✅ 构建前端生产版本 -- ✅ 启动后端服务 -- ✅ 配置静态文件服务 - -#### 方法二：手动修复 - -**步骤 1：构建前端** - -```bash -# 进入前端目录 -cd frontend - -# 安装依赖（首次需要） -npm install - -# 构建生产版本 -npm run build -``` - -构建成功后会生成 `frontend/dist` 目录。 - -**步骤 2：验证构建结果** - -```bash -# 检查 dist 目录是否存在 -dir dist - -# 应该看到： -# index.html -# assets/ -# static/ -``` - -**步骤 3：重启后端服务** - -```bash -# 停止当前运行的服务（Ctrl+C） - -# 重新启动 -go run cmd/main.go -``` - -**步骤 4：访问系统** - -打开浏览器访问：http://localhost:8080 - -应该能看到登录页面。 - ---- - -## 📋 完整排查清单 - -### 1. 检查前端是否已构建 - -```bash -# PowerShell -Test-Path frontend\dist - -# 或 CMD -dir frontend\dist -``` - -如果返回 `False` 或提示目录不存在，需要构建前端。 - -### 2. 检查后端日志 - -启动后端时应该看到： -``` -Server started on port 8080 -``` - -如果没有此输出，查看错误信息并解决。 - -### 3. 检查数据库连接 - -确保 `config/config.yaml` 中的数据库配置正确： -```yaml -database: - host: localhost - port: 3306 - user: root - password: YOUR_PASSWORD # ⚠️ 修改为你的密码 - dbname: exam_registration -``` - -### 4. 检查浏览器控制台 - -按 F12 打开开发者工具，查看： -- Network 标签：是否有 404 错误 -- Console 标签：是否有 JavaScript 错误 - -### 5. 清除浏览器缓存 - -有时浏览器缓存会导致旧版本问题： -- Ctrl+Shift+Delete 清除缓存 -- 或使用无痕模式访问 - ---- - -## 🎯 其他常见问题 - -### 问题：npm install 失败 - -**错误信息：** -``` -npm ERR! code ECONNREFUSED -``` - -**解决方案：** -1. 检查网络连接 -2. 切换 npm 镜像源： -```bash -npm config set registry https://registry.npmmirror.com -npm install -``` - -### 问题：前端构建失败 - -**错误信息：** -``` -Error: Cannot find module 'xxx' -``` - -**解决方案：** -```bash -cd frontend -rm -rf node_modules package-lock.json -npm install -npm run build -``` - -### 问题：后端启动失败 - 端口被占用 - -**错误信息：** -``` -bind: address already in use -``` - -**解决方案：** - -方案 1：关闭占用端口的进程 -```bash -# Windows PowerShell -netstat -ano | findstr :8080 -taskkill /PID <进程 PID> /F -``` - -方案 2：修改端口 -编辑 `config/config.yaml`: -```yaml -server: - port: 8081 # 改为其他端口 -``` - -### 问题：登录后仍然 404 - -**可能原因：** -- Token 未正确保存 -- 路由守卫配置问题 - -**解决方案：** -1. 检查浏览器 Local Storage 是否有 token -2. 检查浏览器 Console 是否有错误 -3. 尝试清除缓存重新登录 - ---- - -## 🆘 获取帮助 - -如果以上方法都无法解决问题： - -1. **查看完整日志** - ```bash - # 启动时查看详细日志 - go run cmd/main.go 2>&1 | tee startup.log - ``` - -2. **检查系统要求** - - Go 1.21+ - - Node.js 18+ - - MySQL 8.0+ - -3. **重新部署** - ```bash - # 删除并重新克隆项目 - # 或备份数据后重新执行初始化流程 - ``` - -4. **联系技术支持** - - 提供完整的错误日志 - - 说明操作系统版本 - - 说明已尝试的解决方法 - ---- - -## ✅ 验证成功标准 - -系统正常运行的标志： - -- ✅ 后端服务启动，显示 "Server started on port 8080" -- ✅ 访问 http://localhost:8080 显示登录页面 -- ✅ 可以使用 admin/admin123 登录 -- ✅ 登录后显示系统首页（Dashboard） -- ✅ 导航栏各菜单可以正常切换 -- ✅ API 请求正常（无 404 错误） - ---- - -**祝您使用愉快！** 🎉 diff --git a/cmd/main.go b/cmd/main.go index 5193827..ac607ae 100644 --- a/cmd/main.go +++ b/cmd/main.go @@ -29,13 +29,22 @@ func main() { // 全局中间件 r.Use(middleware.Cors()) + // 设置路由（必须在静态文件服务之前） + routes.SetupRouter(r) + // 静态文件服务和前端路由回退处理 distPath := "frontend/dist" if _, err := os.Stat(distPath); err == nil { // dist 目录存在，提供静态文件服务 - r.Static("/static", distPath) + // 使用 StaticFS 直接映射根路径到 dist 目录 + r.StaticFS("/static", http.Dir(distPath+"/static")) - // 前端路由回退处理（SPA 支持） + // 显式处理根路径 - 返回 index.html + r.GET("/", func(c *gin.Context) { + c.File(distPath + "/index.html") + }) + + // 前端路由回退处理（SPA 支持）- 放在最后 r.NoRoute(func(c *gin.Context) { // API 路由未找到，返回 404 if len(c.Request.URL.Path) >= 4 && c.Request.URL.Path[:4] == "/api" { @@ -51,9 +60,6 @@ func main() { fmt.Println(" Run: cd frontend && npm install && npm run build") } - // 设置路由 - routes.SetupRouter(r) - // 启动服务器 port := config.Config.GetString("server.port") if err := r.Run(":" + port); err != nil { diff --git a/config/config.yaml b/config/config.yaml index 88fb587..722efbd 100644 --- a/config/config.yaml +++ b/config/config.yaml @@ -6,7 +6,7 @@ database: host: localhost port: 3306 user: root - password: root + password: 123456 dbname: exam_registration charset: utf8mb4 max_idle_conns: 10 diff --git a/frontend/index.html b/frontend/index.html index 0b5644a..a11f61b 100644 --- a/frontend/index.html +++ b/frontend/index.html @@ -5,9 +5,27 @@ 考试信息管理系统 +
- + \ No newline at end of file diff --git a/frontend/src/layouts/BasicLayout.vue b/frontend/src/layouts/BasicLayout.vue index 5176a2a..81f3d8a 100644 --- a/frontend/src/layouts/BasicLayout.vue +++ b/frontend/src/layouts/BasicLayout.vue @@ -119,6 +119,12 @@ const handleLogout = () => { diff --git a/frontend/vite.config.js b/frontend/vite.config.js index 7cdbc22..f576e76 100644 --- a/frontend/vite.config.js +++ b/frontend/vite.config.js @@ -17,5 +17,15 @@ export default defineConfig({ changeOrigin: true } } + }, + build: { + assetsDir: 'static/assets', + rollupOptions: { + output: { + entryFileNames: `static/assets/[name]-[hash].js`, + chunkFileNames: `static/assets/[name]-[hash].js`, + assetFileNames: `static/assets/[name]-[hash].[ext]` + } + } } -}) +}) \ No newline at end of file