本文围绕坤班自研的「校园智能办公协作平台」展开,完整讲解 JavaWeb + Vue3 前后端分离开发全流程,覆盖环境搭建、接口设计、前后端开发、联调测试、项目部署五大核心环节,每个步骤均配套具体操作命令、可复用代码示例和问题排查方案,兼顾新手友好性与实战性,新手可按步骤复刻完成项目开发与部署。


核心技术栈(坤班项目实测稳定版本)


 1.后端:SpringBoot 3.2.4 + MyBatis-Plus 3.5.5 + MySQL 8.0.36 + Redis 6.2.14 + Spring Security 6.2.4(基于 Token 实现身份认证);


 2.前端:Vue3 + Vite 4.5.0 + Pinia 2.1.7 + Element Plus 2.7.2 + Axios 1.6.8;


 3.开发工具:IntelliJ IDEA 2023.3 + VS Code 1.89.0 + Apifox 2.4.18(接口调试);


 4.部署环境:Windows Server 2019(本地测试)、Linux CentOS 8(线上部署)、Nginx 1.24.0(前端静态资源部署 + 反向代理)。


坤班办公平台核心功能

  聚焦校园办公场景,涵盖用户登录认证、考勤管理、审批流程、文档上传下载、部门管理、消息通知等核心模块,代码经优化封装,可直接用于课程设计、实训项目或二次开发。


  111


  前后端分离核心逻辑前端(Vue3)聚焦页面渲染、用户交互与数据展示,运行在浏览器端,通过 Axios 发送 HTTP 请求调用后端接口,不直接操作数据库;后端(JavaWeb)基于 SpringBoot 开发,提供 RESTful 风格 API 接口,负责业务逻辑处理、数据库交互与权限校验,运行在 JVM 虚拟机;前后端通过 HTTP/HTTPS 协议通信,数据统一采用 JSON 格式传输,借助 Token 实现身份认证,并解决跨域问题;开发遵循「先设计接口→后端实现接口→前端调用接口→联调测试→优化→部署」的流程,避免前后端开发脱节。


  项目交付物清单(坤班项目标准)后端交付物包含可运行 Jar 包、数据库脚本(SQL)、核心配置文件(application.yml)、自动生成的接口文档(Swagger);前端交付物包含打包后的 dist 静态文件、源代码、依赖包清单(package.json);部署交付物包含部署文档(环境依赖、启动命令、常见问题)、运维脚本(启动 / 停止 / 重启)。


  关键注意事项版本统一:软件与依赖包版本需匹配(如 JDK 17 适配 SpringBoot 3.x、Node.js 18.x 适配 Vite 4.x),规避版本冲突;编码规范:后端遵循阿里巴巴 Java 开发规范,前端遵循 Vue 官方规范,变量命名与注释清晰(坤班项目附配套规范文档);权限控制:除登录、注册接口外,所有接口均需做 Token 校验,敏感操作需增加角色权限判断;异常处理:前后端均需做好异常捕获,后端返回统一格式的错误信息,前端展示友好提示,避免直接暴露底层报错信息。


业务需求提交