fix

TROUBLESHOOTING.md

@@ -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 错误）
-
----
-
-**祝您使用愉快！** 🎉

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 {

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

frontend/index.html

@@ -5,6 +5,24 @@
     <link rel="icon" href="/favicon.ico">
     <meta name="viewport" content="width=device-width, initial-scale=1.0">
     <title>考试信息管理系统</title>
+    <style>
+      * {
+        margin: 0;
+        padding: 0;
+        box-sizing: border-box;
+      }
+      
+      html, body {
+        width: 100%;
+        height: 100%;
+        overflow-x: hidden;
+      }
+      
+      #app {
+        width: 100%;
+        height: 100%;
+      }
+    </style>
   </head>
   <body>
     <div id="app"></div>

frontend/src/layouts/BasicLayout.vue

@@ -119,6 +119,12 @@ const handleLogout = () => {
 </script>
 
 <style scoped>
+* {
+  margin: 0;
+  padding: 0;
+  box-sizing: border-box;
+}
+
 .layout {
   min-height: 100vh;
 }
@@ -128,6 +134,8 @@ const handleLogout = () => {
   align-items: center;
   justify-content: space-between;
   padding: 0 24px;
+  background: #001529;
+  box-shadow: 0 2px 8px rgba(0, 0, 0, 0.15);
 }
 
 .logo {
@@ -135,6 +143,7 @@ const handleLogout = () => {
   font-size: 20px;
   font-weight: bold;
   margin-right: 40px;
+  white-space: nowrap;
 }
 
 .content {
@@ -142,6 +151,7 @@ const handleLogout = () => {
   padding: 24px;
   background: #fff;
   min-height: 280px;
+  border-radius: 4px;
 }
 
 .user-info {
@@ -156,5 +166,6 @@ const handleLogout = () => {
 .footer {
   text-align: center;
   color: rgba(255, 255, 255, 0.65);
+  padding: 20px;
 }
 </style>

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]`
+      }
+    }
   }
 })