企业官网建设流程全解析

简介：面向小程序毕业设计的悬赏信息发布系统完整项目，基于Java后台与微信小程序前端实现，适合Java方向学生用于毕业设计、课程设计或期末大作业。系统包含前台悬赏发布与后台管理两大模块，覆盖用户登录、悬赏信息管理、文章与图片上传等常见业务，功能完善且带有详细代码注释，新手参照教程即可完成本地部署并直接运行。压缩包共320个文件，整体约44.85MB，内含项目源码、数据库脚本及开发工具；文件以jar依赖、png/jpg/gif界面素材、js/wxml/wxss前端页面、java/class后台代码、xml配置文件为主，同时提供SQL脚本与说明文档，结构清晰便于按前后端分层查阅。已有45人学习该资源，适合需要快速获取可运行完整项目的人群。下载后可获得完整前后端工程，配合数据库与部署教程，能节省环境配置和模块设计时间，尤其适合时间紧、需要高分展示的课程设计或答辩场景。

1. 微信小程序悬赏信息发布系统（Java）：能跑通的毕设源码，比想象中完整

如果一个学生项目里同时出现RewardController、UserController、AdminController、UploadController、ExportExcel这些类名，那基本可以判断这不是套壳页面，而是一个前后端都齐全的完整业务系统。这份源码以微信小程序作为前端，Java SSM/SpringBoot 作为后台，数据库用 MySql 5.7，从登录、悬赏发布、图片上传到管理员审核都串起来了。对正在做小程序毕业设计、课程设计的人来说，最大的价值不是它的界面有多炫，而是它把「小程序端wx.request请求 → Java Controller 处理 → MySql 存取」这条链路完整打通了，下载下来改改配置就能跑。新手能从里面学会前后端怎么联调，熟手也能直接拿走当脚手架改业务。

2. 先看清货：技术栈、模块划分与代码注释质量

2.1 从类名反推项目结构：哪些模块是真实存在的

解压源码后，第一眼应该看controller包下的类，因为 Controller 是前后端交互的入口，类名直接暴露了系统有哪些功能模块。从UserController、RewardController、ArticleController、AdminController、UploadController、ApiController这几个类可以推断，这个项目至少有四类业务：用户体系、悬赏核心业务、文章内容、后台管理。

• UserController：处理用户登录、注册、个人信息更新，常见的做法是接收小程序端传递的code，再拿到openid完成登录。
• RewardController：悬赏信息的发布、列表分页查询、详情查看、状态变更，这是整个系统的核心。
• UploadController：图片上传，悬赏发布时用户需要上传图片，这里封装了文件保存和 URL 返回。
• AdminController：后台管理的接口，比如用户禁言、悬赏审核下线、数据统计。
• ExportExcel：导出功能，管理后台把悬赏数据导出成 Excel，毕设答辩时这也是一个很好的功能亮点。
• BaseDAO：数据访问基类，意味着持久层封装了通用 CRUD，不是每个表单独写一堆重复代码。

看代码的第一步不是跑起来，而是确认这个项目的功能边界。把 Controller 里每个方法对应的@RequestMapping路径整理出来，对照小程序端的request请求地址，能快速判断哪些功能是前后端联通的，哪些只是后端写了但前端没接。

2.2 SSM 还是 SpringBoot：从配置文件和依赖一眼分辨

项目正文里写的是SSM/SpringBoot（如果有的话），这个判断不能靠猜，要打开源码里的pom.xml和配置文件确认。实践中最快的判断方式：

看pom.xml的<parent>节点。如果有spring-boot-starter-parent，说明是 SpringBoot 项目，用内嵌 Tomcat 启动；如果依赖里出现spring-webmvc、mybatis、druid这类坐标，且没有 SpringBoot 的启动类，那就是传统 SSM，需要在外部 Tomcat 里打 war 包部署。

<parent> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-parent</artifactId> <version>2.3.4.RELEASE</version> <relativePath/> </parent>

这段配置一旦出现，就按 SpringBoot 的方式处理：mvn package生成 jar 包后直接java -jar启动，或者生成 war 丢进 Tomcatwebapps。如果没有上述<parent>，那就去web.xml、spring-mvc.xml、mybatis-config.xml找数据源和扫描配置，按传统 SSM 部署。对毕设项目来说，SpringBoot 结构更省事，SSM 结构更贴近课程里教的 SSH 老套路，两者对部署步骤的影响是决定性的。

2.3 数据库脚本与工具包完整度：决定你能不能跑起来的关键

压缩包内部文件结构通常是sql脚本、src源码、README文档、工具安装包、教程视频。sql目录里通常有一份reward.sql或db_reward.sql，里面建库建表加初始化数据一次完成。检查这份脚本是否包含CREATE DATABASE语句，决定了你导入时要不要手动先建库。

工具包这块通常是 Navicat、JDK、Tomcat、MySql 安装包和微信开发者工具。如果压缩包里已经带了我上面说的这些安装包，那就省去了到处找配套版本的时间。这里有个判断经验：看数据库脚本里的建表语句是用backtick反引号包裹表名字段名的，还是纯裸写，这种细节不出问题则已，一出问题就是字符集或者关键字冲突的雷。建议第一遍导入时严格按脚本原样执行，不要手动改表名。

3. 把后端跑起来：IDEA、MySql 5.7、Tomcat 8 的部署顺序与参数细节

3.1 基础环境准备：版本卡住，踩坑减半

先把版本矩阵列出来，这是我在本地和服务器上反复验证过的一组合适配置。

JDK 和 MySql 的安装路径建议选择没有中文和空格的目录，比如C:\Java\jdk1.8.0_181、D:\mysql-5.7.33。很多人部署翻车不是因为不会配置，而是路径里有中文，IDEA 解析配置文件时出现乱码或找不到文件。

IDEA 打开项目后，先把 Maven 仓库路径确认好。如果settings.xml里配置了阿里云镜像，依赖下载速度会快很多。等 Maven 依赖全部下载完成、且 IDEA 的External Libraries里出现了 Spring、MyBatis、MySQL 相关 jar 包后再启动项目，否则会报各种ClassNotFoundException。

3.2 数据库导入：脚本执行顺序与字符集设置

打开 Navicat，连接本机 MySql 5.7，先执行一段字符集设置，再导入项目提供的 sql 脚本。

# 连接 MySql 后先设置字符集 mysql -uroot -p set names utf8mb4; source D:/reward_project/sql/reward.sql;

顺序不能反。先set names utf8mb4是让当前会话的字符集保持一致，避免中文内容写入表里变成问号。source后面的路径用的是正斜杠，在 Windows 下写反斜杠可能被转义。reward.sql里如果包含CREATE DATABASE，导入后数据库会自动创建；如果没有，需要手动执行CREATE DATABASE reward CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;再导入。

导入完成后，重点检查三张核心表：用户表、悬赏表、管理员表。管理员表里如果没有初始账号，可以执行下面的更新语句设置一个默认管理员密码：

UPDATE sys_user SET password = MD5('123456') WHERE username = 'admin';

数据库这边有个隐藏得比较深的坑：如果脚本里的建表语句没有指定ENGINE=InnoDB DEFAULT CHARSET=utf8mb4，而 MySql 5.7 的默认字符集恰好是latin1，那么你后续在小程序端提交中文标题时，存进去的数据会变成乱码，而且这个问题在日志里看不出来，要到后台管理页查看列表时才暴露。导入后立即执行下面这句确认字符集：

SHOW CREATE TABLE reward_info;

看到CHARSET=utf8mb4才算干净。

3.3 修改数据库连接配置：密码、IP、端口一处不落

数据库连接配置通常在application.yml（SpringBoot 项目）、jdbc.properties（SSM 项目）或者spring-database.xml里。需要改的地方是 URL、用户名、密码三项。

# SSM 项目的 jdbc.properties，按实际环境修改 jdbc.driver=com.mysql.jdbc.Driver jdbc.url=jdbc:mysql://localhost:3306/reward?useUnicode=true&characterEncoding=utf8mb4&useSSL=false&serverTimezone=Asia/Shanghai jdbc.username=root jdbc.password=123456

参数说明：localhost:3306是本机 MySql 的地址和端口，如果 MySql 装在其他机器，这里要改成对应 IP；characterEncoding=utf8mb4保证中文不乱码；serverTimezone=Asia/Shanghai解决 MySql 8.0 的时区报错，5.7 加上也不会有副作用。useSSL=false是因为本地开发没必要走 SSL 加密，还能省掉证书警告。

如果你的 MySql 密码是123456，那这里不用动；如果改过密码，这里不换，后面启动项目时就会在日志里看到Access denied for user 'root'@'localhost'。

3.4 启动后端项目：运行还是部署，二选一

如果是 SpringBoot 项目，IDEA 里直接找到主类，类名一般是Application或XxxApplication，右键Run，然后留意控制台输出。看到Tomcat started on port(s): 8080就说明后端已经起来了。

# 如果要用命令行打包启动 mvn clean package -DskipTests java -jar target/reward-system-1.0-SNAPSHOT.jar

-DskipTests的意思是跳过单元测试，避免测试用例因为数据库环境不一致而中断打包。打包时如果下载依赖慢，去settings.xml检查阿里云镜像配置，没有的话加这段：

<mirror> <id>aliyun</id> <mirrorOf>central</mirrorOf> <url>https://maven.aliyun.com/repository/central</url> </mirror>

传统 SSM 项目则是打 war 包放在 Tomcat 的webapps目录，然后启动 Tomcat。启动后访问http://localhost:8080/reward/能出现页面或接口提示，就算部署完成。如果访问 404，先看部署路径对不对，Tomcat 的webapps目录下有没有生成对应的reward文件夹，这一步能排除掉 90% 的部署问题。

4. 小程序端接入：微信开发者工具、appid 配置与接口联调

4.1 导入小程序项目：无 appid 也能预览

微信开发者工具打开后，选择导入项目，目录指向源码里的miniprogram或wechat前端文件夹。AppID 可以选择「测试号」，没有注册小程序账号也能在模拟器里跑通流程。这里有个限制需要提前知道：测试号下不能真机预览，只能模拟器调试，不过对毕设演示来说模拟器已经够用了。

导入后第一件事是检查app.js或utils/request.js里的接口地址。

// utils/request.js 里的公共请求地址，改成你电脑的局域网 IP 或本机地址 const BASE_URL = 'http://localhost:8080/reward/' function request(path, method, data) { return new Promise((resolve, reject) => { wx.request({ url: BASE_URL + path, method: method, data: data, header: { 'Content-Type': 'application/json' }, success: (res) => resolve(res.data), fail: (err) => reject(err) }) }) }

BASE_URL是微信小程序端访问后端服务的根地址。如果后端跑在本机，用localhost或127.0.0.1；后端跑在服务器或者别的机器，就要换成对应的 IP 和 Tomcat 端口。IP 地址怎么确认，Windows 下在命令行执行ipconfig，找到 IPv4 地址填进去即可。

4.2 微信开发者工具里的调试开关：本地联调必须打开

本地调试阶段，小程序默认不让你向http://发请求，只有配置了 HTTPS 合法域名才行。所以模拟器里必须先打开「详情 - 本地设置 - 不校验合法域名、web-view（业务域名）、TLS 版本以及 HTTPS 证书」。

这个开关不打开，你看到的报错永远是request:fail，而且报错信息不会有任何提示告诉你根因。打开后再请求一次，如果后端方法没问题，Network 面板里能看到200返回值，悬赏列表数据也就能渲染出来了。

这里强调的是联调路径的正确性：小程序端wx.request发起请求打向后端的RewardController的映射地址，后端处理完返回 JSON，前端再setData渲染到页面。整个闭环走通后，再谈功能优化和界面调整。

4.3 登录与授权流程：code 换 openid 的实际链路

看UserController里的登录方法，典型的小程序登录流程是：前端调用wx.login()拿到临时 code，把 code 传给后端接口，后端拿着 code 调用微信的jscode2session接口换取openid，再用openid去用户表里查记录，查不到就自动注册新用户，最后返回自定义token或用户 ID。

// pages/login/login.js 中的登录处理 wx.login({ success: (res) => { if (res.code) { wx.request({ url: BASE_URL + 'user/login', method: 'POST', data: { code: res.code, nickname: '微信用户' }, success: (resp) => { wx.setStorageSync('userId', resp.data.userId) } }) } } })

这段代码里res.code是临时凭证，5 分钟失效，所以code必须实时获取，不能缓存。后端拿到code后去调微信接口换openid，这是后端的事情，前端不用关心。如果登录后拿不到userId，先在后端日志里看有没有jscode2session调用的返回值，常见报错是invalid code，原因是前端 code 过期或已被使用过一次。

4.4 用页面反推接口：悬赏列表、详情、发布的联调对照

悬赏发布是小程序端的核心操作。RewardController里对应的接口路径，前端调用时参数必须对齐。从页面表单到后端入库的字段映射是检查重点，比如前端传title、description、rewardMoney，后端实体类就必须有同名字段。实践中有个笨办法但很有效：打开后端方法上的@RequestBody或@RequestParam，逐个字段比照小程序页面data里提交的字段名，字母大小写也要一致。

如果悬赏列表页死活加载不出数据，先打开浏览器开发者工具或微信开发者工具的 Network 面板，看请求返回的 JSON 格式是否跟预期一致。常见的原因是后端返回的是Result包装对象，前端却按裸数据解析，需要在success回调里多取一层res.data.data。遇到这种情况，把返回的 JSON 结构打印出来比对就行，改一行取值代码就能修好。

5. 部署期高频踩坑与排查：五个必看的实战记录

5.1 MySql 8.0 驱动报错与密码加密规则冲突

搞毕设的人最容易在这翻车。项目给的jdbc.properties用的是 5.7 的驱动类com.mysql.jdbc.Driver，而 MySql 8.0 要求换成com.mysql.cj.jdbc.Driver，URL 里还必须带上serverTimezone。如果本机装的是 8.0，启动时大概率会报：

Loading class com.mysql.jdbc.Driver. This is deprecated. The new driver class is com.mysql.cj.jdbc.Driver.

原因：驱动类变更只是其一。8.0 默认的caching_sha2_password加密方式，老项目里的连接池可能不支持，导致明明密码正确却仍然Access denied。解决：要么按推荐版本装 MySql 5.7，要么换驱动并加时区参数，顺带在 MySql 里执行ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY '123456';，把加密方式降级。

5.2 Tomcat 端口被占用，项目启动超时

启动 Tomcat 时如果报端口被占用，先别急着改端口，确认一下是不是已有 Tomcat 在跑：

# Windows 下查看 8080 端口被哪个进程占用 netstat -ano | findstr 8080 taskkill /PID 进程号 /F

这种情况多出现在之前调试过其他项目没有关闭 Tomcat，残留的java.exe进程还在监听端口。杀掉后重新启动即可。如果杀完还是被占用，那可能是 Windows 的 HTTP 服务默认占用了 80 端口或某个软件在监听 8080，那就去 Tomcat 的server.xml里把端口改到 8081，同时记得改回小程序端BASE_URL里的端口。

5.3 小程序端 request 请求报 404，路径根本没对上

前端五花八门的路径问题里，绝大多数是后端项目部署后的上下文路径导致的。SpringBoot 项目如果没配置server.servlet.context-path，上下文路径就是/；传统 SSM 项目部署后上下文路径是webapps下的 war 包名，比如/reward。小程序端BASE_URL里要写http://localhost:8080/reward/，少一个reward就是 404。

排查方式：直接在浏览器地址栏访问http://localhost:8080/reward/user/list这类的接口地址，看能不能返回 JSON。浏览器能通，说明后端没问题，问题在前端某个请求路径拼错。浏览器都是 404，那回去检查项目部署路径名和端口。

5.4 中文乱码：从导入到显示至少三处要设 utf8mb4

乱码问题是最容易排查出所有的漏的，因为链条太长：数据库表字符集、连接 URL 的characterEncoding、小程序的Content-Type、Tomcat 的 URI 编码都要保持一致。其中最常见的遗漏点是 Tomcat 的server.xml里没有配置 URI 编码，GET 请求带中文参数时，到后端Controller里拿到的就是乱码。

<Connector port="8080" protocol="HTTP/1.1" connectionTimeout="20000" redirectPort="8443" URIEncoding="UTF-8" />

解决后验证方法是去后台管理页新增一条悬赏记录，如果是中文标题存入后显示正常，再从小程序端列表里读取，显示也正常，才算真修好——因为某些项目改一个位置就能通，但前后端交互时数据链路里还有一处是latin1，改完之后重启一次才能确认。

5.5 前端渲染空白，白屏但接口返回正常

接口通、数据也有，但是页面空白，这种情况经常是setData的数据路径没有对应到data字段。比如后端返回{code: 200, data: {records: []}}，小程序里写的是this.setData({ list: res.data.records })，但页面初始data里没有list字段，或者在onLoad里用同步方式调用异步接口，数据没回来页面已经渲染完。解决是检查Page.data里的初始字段定义，并且把请求写在回调里再setData。

6. 二次开发的进阶技巧：把 Excel 导出做到答辩加分，再顺手加固一层权限

ExportExcel这个类是这个项目里一个可以重点发挥的功能点。它属于工具性质，基于HttpServletResponse把List<Map>或实体集合写出为.xls文件。二次开发时可以在AdminController里增加一个方法复用这个工具类：先通过selectList查询悬赏记录，再把导出的列名映射到中文表头，比如「悬赏标题」「发布人」「金额」「状态」「发布时间」，最后把数据行逐个写入。

// AdminController 中的导出示例 @RequestMapping("/admin/reward/export") public void exportReward(HttpServletRequest request, HttpServletResponse response) { List<RewardInfo> list = rewardService.selectAllReward(); String[] headers = { "悬赏标题", "发布人", "悬赏金额", "状态", "发布时间" }; String[] fields = { "title", "username", "money", "status", "createTime" }; ExcelExport.export(response, "悬赏列表", headers, fields, list); }

这段代码说明几个要点：headers是表格头部的中文列名，fields是实体类的属性名，两个数组必须一一对应，顺序错了导出数据的列就错位了。ExcelExport.export内部会设置响应头Content-Disposition，让浏览器以附件形式下载文件。这里要注意传入的List里的每个对象，属性名必须和fields完全一致，否则反射取不到值，导出后整列为空。

权限加固方面，AdminController目前是直接暴露在公网路径下的，这意味着任何人知道路径就能访问。我一般会加一个拦截器，统一拦截/admin/**开头的请求路径，校验请求头里有没有携带管理员 token。小程序端每次发起后台请求时就先判断用户角色，如果是普通用户，直接弹提示无权访问。这个改动不大，但会让项目的完整性上一个台阶，因为很多毕设的短板就在后台权限校验上，答辩时往往会被追问。

// 自定义拦截器里的核心校验逻辑 public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception { HttpSession session = request.getSession(); Object userType = session.getAttribute("userType"); if (userType == null || !"admin".equals(userType)) { response.setStatus(401); response.getWriter().write("{\"code\":401,\"msg\":\"无权限访问\"}"); return false; } return true; }

这段代码的作用是权限闸门：没有登录，或者登录用户不是管理员类型，请求到AdminController之前就被拦截，直接返回 401 和提示信息，业务方法根本不会执行。userType是在登录方法里设置进 session 的，正常情况下普通用户登录时存的是user，管理员登录时才是admin。

这个项目拿到手后，建议从最基础的数据库导入开始做，别急着改业务。先把后端跑起来、浏览器能访问接口，再导入小程序端，最后调试登录和悬赏列表，按这个顺序走不容易卡住。我从第一次部署这类小程序毕设开始，就养成了一个习惯：把项目的端口号、数据库密码、前端 BASE_URL、Tomcat 版本四个信息抄在一张纸上，每改一次版本就更新一次。四个信息对得上，项目基本不会跑不起来；对不上，那就是某个环节被遗漏了。希望这个习惯也帮到你。

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