微信小程序+Java后端的心理健康科普平台毕设全解析

简介：面向高校毕业设计人群，这套基于微信小程序与Java SSM框架的青少年心理健康科普平台，提供了一份包含源码、数据库、说明文档和演示视频的完整项目方案。小程序端实现用户注册登录、心理健康知识浏览、心理医生列表查看与在线咨询、个人中心资料修改等功能；后台管理端则完成用户信息验证、健康内容发布、公告推送等运营管理。压缩包共1458个文件，既涵盖Java后端逻辑、Vue管理界面、小程序页面结构（wxml/wxss/js）等核心代码，也有PNG图片、SVG图标、JSON配置、SQL脚本等配套资源，总体积33.49MB，目录划分清晰，便于按模块对照学习。附带的说明文档与演示视频能帮助快速搭建运行并理解业务脉络。已有269人学习下载，非常适合作为毕业设计、课程设计或项目实战练手的参考。

1. 这个毕设包真正值钱的地方，是“能跑、能讲、能扩展”三段闭环

拿到“基于微信小程序+java后端的青少年心理健康科普平台毕业设计”这类压缩包，第一反应通常都是解压、找 README、点开演示视频。但真正决定这份源码价值的，不是代码量有多大、表建了多少张，而是你能不能把它在本地完整跑起来，再在答辩时把“为什么这么设计”讲清楚。这套东西的核心链路其实很朴素：微信小程序作为前端触达用户，Java 后端提供接口，MySQL 数据库存内容与用户数据，管理员在后台维护科普文章和测评量表，用户在小程序里看文章、做测评、拿结果。对正在做毕业设计或者课程设计的人来说，示范价值最大的是三个部分：小程序端与 Spring Boot 后端如何完成前后端分离联调、心理健康测评这种带分支逻辑的业务怎么用表结构和接口落地、以及从本地开发到真机调试再到上线审核会遇到哪些真实问题。这篇博文不讲那些虚的，直接从工程视角把这个平台的骨架拆开，按“理论选型 → 本地跑通 → 模块实现 → 排错进阶”的顺序写，保证每一步都能照着操作。

2. 先想清楚“科普平台”的边界：微信小程序 + Java 后端的模块划分与技术选型

2.1 为什么是“小程序 + Spring Boot”而不是纯网页

心理健康科普平台的目标用户是青少年群体，这个场景下微信小程序有天然优势：无需下载安装、扫码即用、微信登录省去注册流程，而且家长对小程序的心理门槛比下载 App 低得多。Java 后端选 Spring Boot 而不是 SSH 或者 Servlet 手写，理由也很实际——Spring Boot 内嵌 Tomcat，打成一个 jar 就能跑，配合 MyBatis-Plus 操作数据库，写 CRUD 的效率比原生 JDBC 高一个量级，这对毕设周期来说非常关键。

从开发角度讲，这种组合是典型的“前后端分离项目实战”：小程序端只负责渲染和交互，不直连数据库，所有数据都通过 wx.request 调用后端 HTTP 接口获取。这样做的好处是职责清晰，小程序包体积小，而且后端的接口可以被未来可能增加的 Web 管理端复用。你如果想把管理后台也做成网页版，Spring Boot 那套接口都不需要改。

2.2 整体链路与部署视图

把整个平台拆成三条链路来看，结构会非常清楚：

• 用户链路：微信小程序 → 发起 wx.request → Spring Boot 接口 → MyBatis-Plus 操作 MySQL → 返回 JSON → 小程序渲染页面。
• 管理员链路：Web 管理后台（或小程序内嵌的管理页面） → 登录鉴权 → 调用内容管理接口 → 维护科普文章、测评量表、轮播图。
• 数据链路：用户注册信息、测评记录、文章阅读量，全部落到 MySQL，方便后续做数据分析。

接口前缀约定上，我一般会按模块划分，比如/api/article管科普内容，/api/assessment管心理测评，/api/user管用户信息。小程序端在 utils/request.js 里统一封装 baseURL 和 token 注入，避免每个页面重复写请求头。

2.3 核心模块清单：哪些页面和接口是必需品

一个能通过答辩的心理健康科普平台，功能不必贪多，但以下模块是底线：

这里需要特别注意，测评记录表一定要记录每个题目的选项值，而不是只存总分。因为后续如果要扩展“查看历史测评趋势”或者“按题目维度分析”，原始答题数据比一个总分值有用得多。这个细节在答辩时主动讲出来，是明显的加分项。

3. 把 zip 包变成可运行工程：微信小程序与 Java 后端的本地环境搭建

3.1 环境清单与版本选型

拿到源码包后，第一步不是急着改代码，而是确认环境。常见做法是：JDK 1.8 或 17（取决于 pom.xml 里的版本）、Maven 3.6+、MySQL 5.7 或 8.0、微信开发者工具稳定版。前端代码如果是原生小程序语言写的，直接用开发者工具打开即可；如果是 uniapp 工程，则需要用 HBuilderX 运行到微信开发者工具。源码包里的说明文档一般会写清是哪种，这里要养成先读 README 的习惯。

数据库客户端推荐 Navicat，但如果你用的是达梦数据库或 Oracle，连接方式会有差异，本项目的标准配置以 MySQL 为基准。运行环境准备完成后，按顺序执行下面的启动步骤，能避免 90% 的启动报错。

3.2 数据库导入与后端配置

创建数据库并导入源码包里的 SQL 脚本：

mysql -u root -p -e "CREATE DATABASE IF NOT EXISTS mental_health DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;" mysql -u root -p mental_health < sql/mental_health.sql

代码说明：第一行创建数据库，指定 utf8mb4 字符集，这是为了支持文章内容里的 emoji 表情和特殊标点；第二行把 SQL 脚本导入。如果 SQL 文件较大，用 Navicat 的“运行 SQL 文件”功能更直观，但要注意先选中目标数据库再执行。

然后打开后端工程的 application.yml（或 application.properties），重点检查这三项配置：

spring: datasource: url: jdbc:mysql://localhost:3306/mental_health?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai username: root password: 你的数据库密码 driver-class-name: com.mysql.cj.jdbc.Driver mybatis-plus: mapper-locations: classpath*:mapper/**/*.xml configuration: log-impl: org.apache.ibatis.logging.stdout.StdOutImpl

参数说明：serverTimezone=Asia/Shanghai用来解决 MySQL 8.0 的时区报错，不然后端启动时大概率会抛The server time zone value异常；log-impl配置成 StdOutImpl 后，控制台会打印每条 SQL 语句，联调时帮助极大，上线前注释掉即可。

检查无误后在 IDEA 中启动 Spring Boot 主类，看到Started字样就说明后端已经就绪。此时用浏览器直接访问http://localhost:8080/api/article/page?current=1&size=5，如果能返回 JSON 数据，说明接口层正常。

3.3 小程序端联调：appId、合法域名与开发者工具设置

用微信开发者工具导入源码包里的小程序前端目录，这里最容易踩两个坑。

坑一：appId 用的是别人的。在project.config.json里找到appid字段，如果你没有注册小程序账号，可以直接改成测试号touristappid。注意，游客模式下wx.login能正常调用，但部分接口如wx.getUserProfile会受限，后期调试登录流程时建议注册一个个人小程序账号。

坑二：本地开发时后端是 http 协议，而微信小程序正式环境要求 https 且域名必须备案。解决方式是：在开发者工具右上角“详情 → 本地设置”中勾选“不校验合法域名、web-view（业务域名）、TLS 版本以及 HTTPS 证书”。这是仅限开发环境的操作，上线时必须以 https 为准。

小程序端请求封装长这样：

// utils/request.js const BASE_URL = 'http://localhost:8080' function request(path, method = 'GET', data = {}) { return new Promise((resolve, reject) => { wx.request({ url: BASE_URL + path, method: method, data: data, header: { 'Content-Type': 'application/json', 'token': wx.getStorageSync('token') || '' }, success: (res) => { if (res.statusCode === 200) { resolve(res.data) } else if (res.statusCode === 401) { wx.navigateTo({ url: '/pages/login/login' }) reject(res) } else { reject(res) } }, fail: reject }) }) } module.exports = { request, BASE_URL }

逻辑说明：这里把 baseURL 集中管理，避免每个页面写死地址；请求头里统一带上 token，后端通过拦截器校验登录状态。返回 401 时自动跳转登录页，这个设计在答辩讲“会话管理”时可以直接作为案例。更要紧的是把BASE_URL单独抽出来，后面换真机调试时只需改成电脑的局域网 IP。

3.4 后端跨域处理：不处理一定会被问为什么

前后端分离开发时，小程序端请求后端接口不存在浏览器同源策略限制，但如果你把管理后台做成了 Web 页面，跨域问题就立刻浮现。这里推荐在后端写一个全局 CORS 配置类：

@Configuration public class CorsConfig implements WebMvcConfigurer { @Override public void addCorsMappings(CorsRegistry registry) { registry.addMapping("/**") .allowedOriginPatterns("*") .allowedMethods("GET", "POST", "PUT", "DELETE", "OPTIONS") .allowedHeaders("*") .allowCredentials(true) .maxAge(3600); } }

参数说明：allowedOriginPatterns("*")允许所有来源，开发环境方便，生产环境建议换成具体的域名；allowCredentials(true)表示允许携带 Cookie，当你后续把管理员登录改成 Session 机制时会用到。注意，如果用了 Spring Security 或自定义拦截器，预检请求 OPTIONS 需要放行，否则前端会报 CORS 错误但后端日志无异常。

4. 把“科普”做成可交互：内容模块与心理测评的数据库设计和接口实现

4.1 表结构设计：从用户到测评记录

心理测评是本平台最重逻辑的模块，设计好坏直接影响代码复杂度。以下是一套精简但能跑通完整流程的表结构：

-- 测评量表主表 CREATE TABLE assessment ( id BIGINT PRIMARY KEY AUTO_INCREMENT, title VARCHAR(100) NOT NULL COMMENT '量表名称，如：焦虑自评量表', description TEXT COMMENT '量表简介', level TINYINT DEFAULT 1 COMMENT '1=入门 2=进阶', status TINYINT DEFAULT 1 COMMENT '1=上架 0=下架', create_time DATETIME DEFAULT CURRENT_TIMESTAMP ); -- 测评题目表 CREATE TABLE question ( id BIGINT PRIMARY KEY AUTO_INCREMENT, assessment_id BIGINT NOT NULL, content VARCHAR(500) NOT NULL COMMENT '题干', option_json TEXT COMMENT '选项，JSON数组格式：[{"label":"A","score":1}]', sort_order INT DEFAULT 0 ); -- 测评记录表 CREATE TABLE user_record ( id BIGINT PRIMARY KEY AUTO_INCREMENT, user_id BIGINT NOT NULL, assessment_id BIGINT NOT NULL, answers_json TEXT COMMENT '用户答案：[{"questionId":1,"score":2}]', total_score INT, result_remark VARCHAR(255) COMMENT '结果分级：轻度/中度/重度', create_time DATETIME DEFAULT CURRENT_TIMESTAMP );

这里有个设计决策要说明：题目选项采用option_json字段存储 JSON 而不是拆成独立的 option 表，是因为测评题目的选项数量固定、格式单一，拆表反而增加联查复杂度。但是answers_json必须存原始答案，后面计算总分、生成建议都需要这份数据。

4.2 科普文章分页接口：MyBatis-Plus 的常规操作

@RestController @RequestMapping("/api/article") public class ArticleController { @Autowired private ArticleService articleService; @GetMapping("/page") public Result page(@RequestParam(defaultValue = "1") Integer current, @RequestParam(defaultValue = "10") Integer size, @RequestParam(required = false) String category) { LambdaQueryWrapper<Article> wrapper = new LambdaQueryWrapper<>(); wrapper.eq(StringUtils.hasText(category), Article::getCategory, category) .orderByDesc(Article::getTopFlag) .orderByDesc(Article::getCreateTime); Page<Article> page = articleService.page(new Page<>(current, size), wrapper); return Result.success(page); } }

代码说明：eq方法第一个参数传 boolean，条件为 true 时才拼接该查询条件，这是category为空时查出全部文章的关键写法；Page是 MyBatis-Plus 的分页模型，返回对象里包含records、total、current、size四个字段，前端分页直接取用即可。这里还用了两层排序，置顶文章优先，再按创建时间倒序，这是科普内容平台的常规排序策略。

对应小程序端首页的下拉加载更多，只需要判断res.data.records.length > 0时追加到列表尾部，否则提示没有更多了。

4.3 心理测评流程：题目加载到结果计算的完整链路

测评提交接口是整个平台业务复杂度最高的地方，核心代码逻辑如下：

@PostMapping("/submit") public Result submit(@RequestBody SubmitDTO dto, @RequestHeader("token") String token) { // 1. 校验用户登录状态 Long userId = userService.getUserIdByToken(token); if (userId == null) { return Result.error(401, "请先登录"); } // 2. 查询量表信息 Assessment assessment = assessmentService.getById(dto.getAssessmentId()); if (assessment == null || assessment.getStatus() != 1) { return Result.error(400, "量表不存在或已下架"); } // 3. 计算总分 int totalScore = 0; for (AnswerItem item : dto.getAnswers()) { totalScore += item.getScore(); } // 4. 根据总分区间生成评估结果 String level = assessLevel(totalScore, assessment.getLevel()); // 5. 保存测评记录 UserRecord record = new UserRecord(); record.setUserId(userId); record.setAssessmentId(dto.getAssessmentId()); record.setAnswersJson(JSON.toJSONString(dto.getAnswers())); record.setTotalScore(totalScore); record.setResultRemark(level); userRecordService.save(record); return Result.success(buildResult(level, totalScore)); }

逻辑说明：步骤 3 遍历前端提交的答案，累加每个选项的分数，这里没有在数据库里联查 score，因为前端提交时已经把每题所选选项的分数带过来了，但这种做法把数据可信度寄托在前端。更严谨的写法是拿着questionId列表回到question表查正确的分数再计算，本示例为了简洁采用前端传分，答辩时如果能主动指出这一点并说出改进方案，效果会很好。

步骤 4 的分级建议需要根据量表类型定制。以焦虑自评量表为例，常见区间是：

注意，平台定位是“科普”，不是“诊断”，所以返回结果里必须带一句免责说明：“本测评结果仅作自我了解参考，不构成医学诊断依据”。这句话放在结果页底部，既是产品合规要求，也是答辩时体现工程素养的细节。

4.4 小程序端“修改刚进入的加载页面”与启动优化

热词里高频出现“修改刚进入的加载页面”，对应到这个小程序项目里，其实就是两件事：修改启动时的第一个页面、优化首屏加载体验。

小程序启动默认进入app.json里pages数组的第一个页面，如果你想把启动页从首页改成“测评分类页”，直接调整数组顺序即可。更常见的是“启动闪屏 + 加载中”体验：在app.json的window节点配置backgroundColor和backgroundTextStyle，让启动过程不是白屏；同时在首页onLoad里用wx.showLoading配合请求完成后的wx.hideLoading，避免用户看到空白页面，然后才开始请求接口的现象。

另一个影响“刚进入”体验的细节是：不要在小程序启动时同步执行过多的本地缓存读写。比如把文章列表缓存到 Storage 时，应该先渲染缓存内容再发请求更新，而不是等接口返回才渲染。涉及wx.setStorageSync大量数据写入时，可以考虑用异步版wx.setStorage，避免阻塞页面渲染。

5. 毕业设计加分项：真机调试、上线审核与“危机干预提示”扩展

5.1 上线前必查的三件事

第一件，微信公众平台后台配置 request 合法域名，必须为 HTTPS 且已备案的域名，开发环境的 IP 地址在这里不生效。第二个是服务器端配置，Spring Boot 项目打包成 jar 后部署到云服务器，注意释放安全组 8080 端口权限。第三件事是wx.getUserProfile接口在最新基础库里必须由用户主动点击触发，不能在onLoad里直接调用，否则真机预览会静默失败。这三条是微信平台审核经常卡住的地方，提前检查能少一周修改时间。

5.2 拓展：给测评结果接上“危机干预提示”

原版的测评结束往往止步于一个结果页，但如果想让项目在答辩时脱颖而出，可以扩展“危机干预提示”逻辑——这是青少年心理健康平台的刚需场景。不需要额外建表，只改接口的返回逻辑：当totalScore达到重度区间时，在返回结果里多塞一个emergency_contact字段，内容可以是全国心理援助热线或“建议在家长陪同下尽快就医”的文案，前端检测到该字段时以显眼的样式渲染。这段逻辑代码量不大，但对产品意义的提升非常明显，答辩时能讲清楚“从功能实现到社会价值”的转变。

5.3 最终验证：一条从首页到测评报告的全链路自查清单

• 未登录状态点击测评，能跳转登录页且登录后回跳到原测评页。
• 提交测评后，数据库的user_record表增加一条记录，answers_json内容与前端选择一致。
• 连续提交两次相同量表，结果页总分级一致。
• 管理员在后台把某篇文章下架后，小程序首页刷新不再显示该文章。
• 使用微信开发者工具“真机调试”，iPhone 和 Android 各跑一遍答题流程，确认答题页面的底部安全区按钮不被遮挡。

把这五条跑通，这个平台从源码到可演示成熟度就都验证到位了。

本文还有配套的精品资源，点击获取