简介：一套基于微信小程序的助农扶贫系统开源毕业设计资料包，面向Java方向毕设学生及微信小程序开发者，覆盖管理员、农户、用户三类角色，实现商品管理、订单发货、在线购买、支付、评价与退货等核心业务闭环，可快速理解农产品电商类项目的完整开发思路。资源共1205个文件，压缩包约35.44MB，其中png图片、vue页面、java后端源码、wxss/wxml小程序样式与结构、json配置文件等各司其职，便于对照学习前后端交互与小程序原生开发方式。已有219人学习下载。资料包内附MySQL数据库脚本、开题报告、毕业论文、答辩PPT及详细使用说明，目录分类清晰，既能直接导入运行，也适合在此基础上扩展功能或撰写毕业设计文档，是完成助农扶贫主题项目的实用参考。

1. 小程序 + Java 后台的助农系统：我把整套本地环境装通用了

做毕业设计选微信小程序方向的同学，十有八九会撞上同一个坎：小程序前端代码拿得到，Java 后台也能启动，但数据就是不通、页面就是白屏、订单就是提交不上去。我这次装的是一套完整的助农扶贫微信小程序系统，前端基于微信开发者工具，后端是 Java 生态的 SSM 框架，数据库用的 MySQL，还附带开题报告、论文、PPT 和使用说明这些毕业设计必备材料。整套东西如果只会在 IDE 里点运行，那你大概率会在「数据库连不上」「端口被占用」「小程序合法域名没配」这几个坑里反复横跳。这篇文章我从零开始装一遍，把你一定会踩的坑提前踩掉，照着做就能把前端、后台、数据库三条线全部跑通。

这套环境适合谁？正在做微信小程序类毕业设计的学生、想快速搭一个「用户 + 农户 + 管理员」三端后台的开发者，以及拿到源码却不知道从哪一步开始的人。我不会只讲「点下一步」，而是把 JDK 版本、MySQL 字符集、后端配置文件、小程序请求域名这些真正决定成败的细节全部拆开讲。

2. 装前准备：环境清单、版本选择与三个最常拖垮安装的隐患

2.1 这套系统到底需要哪些软件

在动手之前，先把要装的软件列清楚。这套助农扶贫系统分为小程序前端、Java 后台和 MySQL 数据库三部分，前端使用微信开发者工具打开，后台是标准的 Java Web 项目，数据库用 MySQL 5.7 或 8.0 都可以跑。下面是我整理的环境对照表：

我这次用的是 JDK 1.8 + MySQL 8.0.28 + 微信开发者工具稳定版 + IDEA 2023，这套组合能跑通。如果你之前电脑上装过 JDK 17 或 MySQL 8.0 以上版本，建议先看清楚版本，老项目对 JDK 版本非常敏感，JDK 版本不对会出现UnsupportedClassVersionError或者 Spring 容器启动直接失败。

2.2 JDK 安装：环境变量三个最容易写错的路径

JDK 安装本身不难，难的是环境变量。Windows 上我习惯装到C:\Java\jdk1.8.0_221，注意整个路径不要出现中文和空格。装完后配置三个系统变量，下面是具体操作。

先新建JAVA_HOME：

JAVA_HOME = C:\Java\jdk1.8.0_221

再编辑Path，在最前面新增两行：

%JAVA_HOME%\bin %JAVA_HOME%\jre\bin

最后新建CLASSPATH：

CLASSPATH = .;%JAVA_HOME%\lib\dt.jar;%JAVA_HOME%\lib\tools.jar

这里最容易翻车的是 CLASSPATH 最开头的那个点号，它代表当前目录，漏掉的话编译时找不到类。第二个坑是 Path 里必须新增%JAVA_HOME%\jre\bin，有些人只加了bin，导致java -version能出来但javac命令找不到。第三个坑是配置完后没有新开命令行窗口，旧窗口里环境变量不会刷新，验证时还以为没配成功。

验证方式是在新开的 CMD 里执行：

java -version javac -version

两个命令都输出版本号说明 JDK 装好了。如果java -version显示的不是 1.8，检查一下 Path 里是不是有别的 JDK 路径排在前面，把多余的删掉即可。

2.3 MySQL 安装：字符集和认证插件决定了后面能否导入成功

MySQL 的安装方式很多，我这次用 MySQL Installer 装 8.0.28，安装过程中有两个选择会直接影响后续操作。第一是字符集，在安装向导的 MySQL Server Configuration 步骤里，Character Set 要选utf8mb4，不要选默认的latin1，否则导入带 emoji 表情的商品评价数据会乱码。第二是认证插件，8.0 默认是caching_sha2_password，而很多老项目的 JDBC 驱动不支持这个插件，连接时会报Unable to load authentication plugin 'caching_sha2_password'。

解决方式有两种：一种是把 JDBC 驱动换成mysql-connector-java 8.0.x版本，项目 pom.xml 里改一下就行；另一种是登录 MySQL 后执行下面的 SQL，把 root 用户的认证插件改回mysql_native_password：

ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY '你的密码'; FLUSH PRIVILEGES;

我一般直接换驱动，省事。另外安装时务必记好 root 密码，后面导入数据库和修改后台配置文件都要用。装完 MySQL 后，用命令行验证一下服务是否启动：

net start mysql80 mysql -uroot -p

能进入mysql>提示符就说明数据库服务正常。如果是 5.7 版本，服务名可能是mysql57，用net start mysql不一定对得上，可以在服务管理器里看准确的名称。

2.4 微信开发者工具安装：版本选择和登录方式

微信开发者工具直接用官网稳定版就行，安装过程没有特别多坑，唯一需要注意的是登录方式——必须用微信扫码登录，而且小程序后台需要提前注册一个测试账号。如果你只是本地调试，不需要小程序 AppID，可以在创建项目时选择「测试号」，这样不需要注册小程序账号也能把前端跑起来。

打开开发者工具后，选择「导入项目」，目录指向源码里的小程序前端文件夹，AppID 选择测试号即可。如果导入后页面空白，大概率是目录选错了，应该选包含app.js、app.json的那一层，而不是外层文件夹。

3. 数据库导入与后端配置：让 Java 后台连上 MySQL

3.1 导入数据库脚本：三步完成建库建表

这套系统提供的有.sql文件，通常在源码的db或database文件夹下。导入之前先建一个空的数据库，再用命令行或可视化工具导入。我习惯用命令行操作，因为能清楚看到报错信息。

登录 MySQL 后执行：

CREATE DATABASE IF NOT EXISTS help_farmer DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; USE help_farmer; SOURCE C:/path/to/help_farmer.sql;

SOURCE后面的路径是 SQL 文件的绝对路径，Windows 下要注意斜杠方向，用正斜杠/或双反斜杠\\，不要用单反斜杠。如果导入过程中报Unknown collation之类的错误，大概率是 SQL 文件是用 MySQL 5.7 导出的，而你的 8.0 版本不支持那种排序规则；或者反过来。解决办法是用可视化工具重新导出一次，或者直接用支持版本匹配的 SQL 文件。

导入完成后，查看一下表是否齐全：

USE help_farmer; SHOW TABLES;

正常的表数量在 10～15 张左右，包含用户表、农户表、商品表、订单表、评价表、退货表、管理员表等。如果表数量明显不够，说明 SQL 文件没有完整导入，检查一下是不是有外键约束导致部分表创建失败。

3.2 后端配置文件修改：数据库连接四要素逐个核对

Java 后台的数据库配置在application.yml或jdbc.properties里，这套系统用的是前者。找到文件后，重点修改下面四个值：

spring: datasource: url: jdbc:mysql://localhost:3306/help_farmer?useUnicode=true&characterEncoding=utf8mb4&useSSL=false&serverTimezone=Asia/Shanghai username: root password: 你的数据库密码 driver-class-name: com.mysql.cj.jdbc.Driver

URL 里的serverTimezone=Asia/Shanghai是 8.0 版本必填的，不加会报时区错误。characterEncoding=utf8mb4保证中文和 emoji 不会乱码。driver-class-name如果是 8.0 驱动要写com.mysql.cj.jdbc.Driver，如果是老驱动则是com.mysql.jdbc.Driver，写反了会启动报错。

修改完之后，在 IDEA 里刷新 Maven 依赖，等待下载完成。如果下载依赖速度慢，可以在 Maven 的settings.xml里配置阿里云镜像，这个不是必须的，但能节省大量时间。

3.3 启动后端项目：看日志定位问题

后端项目是一个标准的 Spring Boot 或 SSM 项目，启动入口在某个带main方法的类里。IDEA 里直接运行Application类，观察控制台输出。正常启动的标志是出现Started或Tomcat started on port(s): 8080之类的日志，说明后台已经跑起来了。

如果启动失败，按下面顺序排查：

# 查看端口占用 netstat -ano | findstr 8080 # 查看具体进程 tasklist | findstr 端口对应的PID

端口被占用是最常见的问题。如果 8080 被其他程序占用了，要么关掉占用进程，要么在后端配置文件里改端口，比如改成server.port=8090，然后小程序前端所有请求 URL 同步修改。这一步很多人漏掉，改了后台端口却忘了改小程序代码里的接口地址，结果前端一直报request:fail。

4. 小程序前端导入与配置：从空白页面到能调通接口

4.1 导入项目：目录选对了就成功一半

打开微信开发者工具，点击「导入项目」，把项目目录选到前端代码所在文件夹。关键点在于必须选到包含app.js的那一层，很多同学选到外层，导致开发者工具提示「不是小程序项目」。导入后在开发者工具里能看到模拟器、目录树和代码编辑区三块，此时可能页面是空白的，这是正常的，因为后端还没连上或请求地址没配对。

如果导入时提示app.json解析错误，通常是文件编码问题。用记事本或 VSCode 打开app.json，改成 UTF-8 编码保存再重新导入即可。这个坑很隐蔽，但遇到的人不少。

4.2 全局配置：app.js 里的请求地址

打开app.js或utils/request.js，找到全局请求地址配置，通常是这样的：

const BASE_URL = 'http://localhost:8080'

这里的地址必须和后台启动的端口完全一致。如果你改了后台端口，这里就要改成http://localhost:8090。注意微信开发者工具默认不校验合法域名，但真机预览时必须在微信公众平台配置 request 合法域名，否则真机上所有请求都会失败。本地调试阶段不需要配，直接点「不校验合法域名」即可。

4.3 登录流程联调：从模拟器到真机的完整请求链

小程序前端里有登录、注册、商品列表、购物车、订单、个人中心等页面。先跑通登录流程，因为很多页面的数据依赖 token。在模拟器里输入用户名密码，点击登录，如果网络请求正常，Network面板里能看到POST /api/user/login的请求，响应里返回 token 字符串。拿到 token 后，其他所有需要鉴权的接口都会自动带上。

如果请求失败，打开开发者工具右上角的「详情 → 本地设置」，勾选「不校验合法域名、web-view（业务域名）、TLS 版本以及 HTTPS 证书」。这一步不做，本地调试时所有请求都会被拦截，这是小程序开发里最容易卡住的地方，但往往不是代码问题，而是设置问题。

4.4 图片上传与商品展示：静态资源路径要相对不要绝对

商品图片、农户头像这类静态资源，小程序里通常直接引用后台返回的 URL。这套系统的商品表里有图片字段，存储的是相对路径或完整 URL。如果图片显示不出来，看后台返回的是什么格式。

// 商品图片渲染 <image src="{{item.image}}"></image>

如果item.image存的是/upload/xxx.jpg这类相对路径，那小程序无法直接访问，需要补齐域名前缀：

// 补齐完整的图片地址 const fullUrl = BASE_URL + item.image

这一步是把图片路径拼成http://localhost:8080/upload/xxx.jpg的完整地址，模拟器里能显示真机才能显示。

5. 避坑指南：这套环境最常见的 5 个报错与对应解法

5.1 报错：Access denied for user 'root'@'localhost'

现象是后端启动时数据库连接失败，控制台出现Access denied for user 'root'@'localhost' (using password: NO)或YES结尾。

原因是数据库密码和配置文件里的密码不一致。有时候你以为装 MySQL 时设置的密码是root，实际可能记错了，或者安装时选择的认证方式导致密码策略不一样。

解决办法是先用命令行登录确认密码，再修改后端配置文件。如果完全忘了密码，可以临时跳过权限表重启 MySQL，但这招比较暴力，我一般直接卸载重装 MySQL，反而更快。

5.2 报错：Cannot load driver class: com.mysql.cj.jdbc.Driver

现象是 pom.xml 里没有引入数据库驱动依赖，或者依赖版本不对。

原因通常是源码里没有把 MySQL 驱动依赖写全，或者 IDE 没有刷新 Maven 依赖。

解决方式是打开pom.xml，确认有这一段：

<dependency> <groupId>mysql</groupId> <artifactId>mysql-connector-java</artifactId> <version>8.0.28</version> </dependency>

加完后点击 Maven 面板的刷新按钮，等待依赖下载完成再启动。

5.3 报错：小程序请求显示 request:fail

现象是模拟器里点击登录或获取商品列表时，请求直接失败，Network 面板显示request:fail。

原因是本地设置里没有勾选「不校验合法域名」，或者请求地址写成了https://而后台用的是http://。

解决方式是先在详情 → 本地设置里勾选不校验合法域名，然后确认请求 URL 是http://localhost:8080。如果是在真机上调试，需要在小程序后台把这个本地地址加入白名单，但本地 IP 经常变化，我建议先在模拟器里把功能跑通再看真机的事。

5.4 报错：端口占用导致后台启动失败

现象是控制台输出Port 8080 was already in use或类似内容。

原因是某个进程占用了 8080 端口，常见的是其他 Java 程序、Tomcat 服务或者某些开发工具的调试端口。

解决方式有两种。快速方式是找到占用进程并结束，命令如下：

netstat -ano | findstr 8080 taskkill /PID 进程号 /F

如果不方便结束进程，直接在application.yml里改端口，比如server.port=8090，然后同步修改小程序前端app.js里的BASE_URL。这一步改完记得重启后端，否则不生效。

5.5 报错：小程序提示 合法域名校验出错

现象是开发者工具里请求正常，但在手机上预览时所有接口都失败，提示不在以下 request 合法域名列表中。

原因是微信公众平台的服务器域名配置里没有加入后台接口域名，而真机预览会强制校验合法域名。

解决方式是在小程序后台的「开发管理 → 服务器域名」里添加request 合法域名，填上你后端服务的公网 IP 或域名加端口。本地调试阶段只能在开发者工具里关掉校验凑合跑，要在手机上用就必须配一个公网可访问的后端地址，或者使用内网穿透工具临时映射一下。

我自己的习惯是先把所有功能在模拟器里全部跑通，再考虑真机调试，这样能把调试范围控制在代码本身，而不是被网络和域名问题干扰。

6. 装完怎么验证跑通：从数据库到小程序页面的完整冒烟测试

整套环境装完后，不要急着写论文，先把系统从头到尾走一遍真正的业务流，确认每个环节真的通了。我习惯用一个固定顺序做冒烟测试，大概五分钟左右就能把前后端所有关键链路验证完。

第一步，打开数据库可视化工具，连接到help_farmer库，确认所有表已经存在。随便打开用户表，手动插入一条测试用户数据，密码字段如果存的是明文就填明文，如果是加密的就用后台注册接口自动生成的用户来测，不要手动改加密字段，否则登录接口校验不过还以为是环境问题。

第二步，启动后端项目，等待控制台输出启动成功的日志。然后打开浏览器，直接访问一个简单的后端接口地址，比如http://localhost:8080/api/user/login，如果浏览器返回一段 JSON 或 405 之类的响应，说明后台已经对外提供服务了。如果浏览器都打不开，直接看控制台报错，不用往下测。

第三步，打开微信开发者工具，导入前端项目，勾选不校验合法域名。在模拟器里进入登录页面，输入刚才插入的测试用户或通过注册接口新建一个用户，点击登录。观察 Network 面板，确认请求返回200和 token 字符串。登录成功后在个人中心或首页能看到用户昵称已刷新，说明前端把 token 存到了本地缓存并能读取，这条链路就算通了。

第四步，测核心业务流。作为用户，在商品列表页选择一件商品加入购物车，然后提交订单，支付环节如果有模拟支付就直接点支付，没有就确认下单。订单生成后，去订单列表页确认能看到订单号和状态。这条链路覆盖了商品查询、购物车、订单创建三个最核心的后端接口，只要没报错，大部分功能都通了。

第五步，换一个身份登录。退出当前账号，用农户账号登录，在农户管理页面里应该能看到待发货订单，点击发货后，订单状态变化。再换管理员账号登录，确认能在后台看到订单统计和用户管理数据。三个角色的权限体系能跑通，说明后端的权限拦截配置也没有问题。

做完这一步，整套系统基本可以放心使用了。从那以后我每次拿到一套新源码，都会强制自己先走一遍这五步冒烟测试，再开始改代码或者写论文，避免在环境问题上浪费时间。希望帮到你，祝安装顺利。

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