交通统计报表审核系统 — 打包与部署说明

适用：合并后 main 分支（2026-08-27 起）。后端 Spring Boot 2.7（Java 8），前端 Vue 2 + Element UI。
本文档面向开发与部署同事，命令均在 Windows 下验证。

一、项目结构

二、环境要求

三、数据库初始化

先执行建库建表脚本，再按需导入城市客运数据：

mysql --default-character-set=utf8mb4 -h <主机> -P 3306 -u root -p < docs/init.sql
mysql --default-character-set=utf8mb4 -h <主机> -P 3306 -u root -p traffic_audit < docs/sql_city_bus.sql
mysql --default-character-set=utf8mb4 -h <主机> -P 3306 -u root -p traffic_audit < docs/sql_city_taxi.sql

• init.sql 会重建 traffic_audit 库并预置初始账号：admin / admin123（生产环境请登录后改密码）
• sql_city_bus.sql、sql_city_taxi.sql 为城市客运（公交/出租）示例数据，按需导入

四、打包

4.1 后端（项目根目录执行）

cmd /c "mvn -q clean package -DskipTests -f traffic-audit-server\pom.xml"

产物：traffic-audit-server\target\traffic-audit-server-1.0.0-SNAPSHOT.jar（可执行 fat jar，约 57MB）。

4.2 前端（traffic-audit-web 目录执行）

cd traffic-audit-web
npm run build

产物：traffic-audit-web\dist\（index.html + css/js/fonts，纯静态文件）。

五、部署目录结构（推荐）

deploy\
├─ app.jar                    # 后端 jar（可改名）
├─ docs\                      # 必须：模板与目录导入数据目录
│  ├─ 城市客运\
│  ├─ 公路旅客\
│  ├─ 货运\
│  ├─ 能耗\
│  ├─ 投资\
│  │  └─ 模板\
│  └─ (6月\ 7月\ 等导入数据目录，按需)
└─ web\                       # 前端 dist 的内容（由后端 8090 托管）
   ├─ index.html
   ├─ css\  js\  fonts\

关键点：

• docs 必须放在 jar 同级。后端运行时按启动目录向上查找 docs（报表导出的 Word 模板、导入页「下载模板」、目录导入数据都从这里读），找不到会报「未找到数据目录 docs」或「未找到模板文件 xxx」。
• 首次部署直接把项目里的整个 docs 拷过去最稳妥；后续可精简（只留模板子目录），详见「常见问题」。
• application.yml 打包在 jar 内，已内置前端静态托管（file:./web/）；部署机需要改配置时，可在 jar 同级放一个外置 application.yml（外置优先级高于内置，注意需包含完整配置），或改完再打包。
• 启动后浏览器直接访问 http://<服务器>:8090，无需额外 Web 服务器。

六、关键配置（application.yml）

注意：仓库只提交占位模板 application.yml.example，真实 application.yml 不入库。

七、启动后端

cd deploy
java -jar app.jar

• 成功标志：日志出现 Started TrafficAuditApplication 和 Tomcat started on port(s): 8090。
• 在 deploy 目录下启动即可命中同级的 docs。

八、前端部署（推荐：Spring Boot 直接托管，无需 IIS/nginx）

• 把前端构建产物 dist 的内容放到 jar 同级目录 web\（即 web\index.html、web\js\、web\css\、web\fonts\）。
• 后端已内置：spring.web.resources.static-locations: file:./web/（静态托管）+ 安全配置放行静态资源，启动后直接访问 http://<服务器>:8090 即可，页面与 /api 同源，**不需要 IIS/nginx 反代**。
• 前端路由为 hash 模式，刷新/直达无 404 问题。

备选：nginx 托管 + /api 反代（如需前后端分离）

server {
    listen 80;
    server_name _;
    root D:/deploy/web;            # 前端 dist 目录
    index index.html;

    location / {
        try_files $uri $uri/ /index.html;
    }

    location /api {
        proxy_pass http://127.0.0.1:8090;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    }

    client_max_body_size 100m;     # 上传 Excel 需要，与后端 multipart 100MB 对齐
}

若前端由 IIS 托管，需安装 URL Rewrite 2.0 + ARR 3.0 并启用 proxy，站点根目录放 docs/iis-web.config.example（重命名 web.config），规则示例见该文件。

九、部署后验证

1. 浏览器打开 http://<服务器>:8090；
2. 用 admin / admin123 登录（生产改密后使用新密码）；
3. 数据导入：下载模板 → 上传 Excel（或目录导入）；
4. 报表：查询 → 预览/导出（依赖 docs 模板文件）；
5. AI 分析：需配置 deepseek.api-key 后可用。

十、常见问题

十一、开发环境日常启动

项目根目录运行一键脚本（自动拉起后端 8090 + 前端 8080）：

powershell -NoProfile -ExecutionPolicy Bypass -File start-dev.ps1