企业官网建设流程全解析

“058协作机器人门户网站系统”这个标题，一看就是从毕业设计或者企业信息化项目里来的。协作机器人这两年不新鲜了，但是围绕它的门户网站系统，很多团队还在用传统多页应用硬啃，维护起来相当痛苦。这次我基于Spring Boot + Vue的组合，把整套门户从零到一搭了一遍，接下来直接把我实际做的设计、代码结构和踩坑记录全部摊开讲，项目最后打包成一个可运行的单体Jar包，前后端不再分家。

1. 项目整体设计与技术选型思路

1.1 协作机器人门户网站到底解决什么问题

协作机器人（Cobot）门户网站，本质上是一个面向“人”的展示与信息管理平台。它不像工业机器人控制系统那样需要高实时性，核心业务集中在几个方向：机器人型号展示、参数对比、应用场景案例、行业新闻动态、技术文档下载，以及后台管理端的用户权限、内容审核和数据统计。

这就决定了它的技术诉求很明确：页面交互要顺滑、内容要能灵活管理、接口要清晰稳定。门户网站的访客通常不会在列表页停留太久，他们要的是快速看到负载、臂展、重复定位精度这些关键参数，最好还能直接按参数筛选。后台管理员要的是能快速发布文章、上下架产品、管理图片资源，而不是对着改代码。

我之前见过不少团队用JSP或者Thymeleaf做这类门户，页面多了以后，前端和后端代码完全纠缠在一起，一个 banner 图样式改动都可能要重启服务。所以这次直接采用前后端分离：Spring Boot 只负责提供 RESTful API，Vue 负责页面渲染和交互。开发时期用 Vite 的代理转发请求，生产时期把 Vue 构建产物放进 Spring Boot 的静态资源目录，一个 Jar 全部搞定。

1.2 为什么是 Spring Boot + Vue，而不是其他方案

有人会问，这种门户网站用 Node.js + React 不也一样吗？确实可以，但这里有个很现实的场景：项目要部署在学校或者企业内部服务器上，运维人员最熟悉的往往还是 Java 技术栈。Spring Boot 的自动配置和内置 Tomcat，让部署变成了一条java -jar命令的事情，省去了单独配置 Nginx 和 Node 运行时的步骤。

选择 Vue 而不是 React，也有实际原因。Vue 的学习曲线相对平缓，模板语法对后端出身的人来说非常友好。尤其在做门户这种以展示为主的项目时，Vue 的单文件组件（SFC）可以把一个机器人详情页的模板、脚本、样式全部收拢在一起，团队成员各自维护不同的组件，冲突概率明显比传统 JSP include 方案低很多。

版本选择上也要说清楚，我这次用的是 Spring Boot 2.7.18，不是最新的 3.x。因为 3.x 基于 Jakarta EE，javax 包名全部变成了 jakarta，很多老牌的代码生成器和数据库插件还没有完全适配。如果团队里有人习惯用 MyBatis Generator 反向生成代码，Spring Boot 2.7 绝对是当前的稳妥选择。Vue 那边用的 3.4 版本，配合 Vite 5 和 Vue Router 4，组合拳比较成熟。

2. 后端设计：Spring Boot 核心模块拆解

2.1 项目结构和 Maven 父子工程构建

后端我用的是标准的 Maven 多模块结构，但基于部署便利考虑，最终只保留一个可执行模块。项目目录是这样规划的：

cobot-portal-backend/ ├── cobot-common/ # 公共模块：工具类、统一返回结果、异常处理 ├── cobot-system/ # 核心业务模块：权限、用户、角色、菜单 ├── cobot-content/ # 门户内容模块：产品、新闻、案例、文档 └── cobot-admin/ # 启动模块：Application入口、配置、定时任务

模块划分的逻辑很简单：把权限体系和内容体系拆开。因为这套系统的后台管理不仅给门户用，后续如果要接入内部的知识库或者工单系统，cobot-system 可以直接复用，不用再做一遍登录和权限。

构建的时候需要特别注意 Java 版本一致性问题。各模块的pom.xml里我都显式指定了：

<properties> <java.version>1.8</java.version> <maven.compiler.source>1.8</maven.compiler.source> <maven.compiler.target>1.8</maven.compiler.target> </properties>

这里有一个实操细节值得拿出来说：如果某个模块忘记指定编译版本，而你的机器默认 JDK 是 17，Maven 编译时会报“无效的目标发行版”错误。就算你在 IDE 里改了对单个模块的编译级别，多模块构建时父 POM 的 properties 依然会覆盖子模块配置。所以统一在父 POM 中声明是正确做法。

2.2 数据库设计与数据模型

门户网站的数据模型不太复杂，但要把关键表设计透彻。我的核心表如下：

-- 机器人产品表 CREATE TABLE cobot_product ( id BIGINT PRIMARY KEY AUTO_INCREMENT, name VARCHAR(100) NOT NULL COMMENT '产品名称', model_no VARCHAR(50) NOT NULL COMMENT '型号', payload_kg DECIMAL(5,2) COMMENT '额定负载/kg', reach_mm INT COMMENT '工作半径/mm', repeatability_mm DECIMAL(6,3) COMMENT '重复定位精度/mm', weight_kg DECIMAL(6,2) COMMENT '本体重量/kg', image_url VARCHAR(255) COMMENT '主图URL', detail_html TEXT COMMENT '详情页富文本', status TINYINT DEFAULT 1 COMMENT '1上架 0下架', sort_order INT DEFAULT 0, create_time DATETIME DEFAULT CURRENT_TIMESTAMP, update_time DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='协作机器人产品表';

DO NOT omit重要，但答案已截断。在 此处继续