拓冰网站定制 
简介这是一套面向高校学生与Java初学者的微信小程序悬赏信息发布系统完整项目包适用于毕业设计、期末大作业与课程设计场景。项目采用小程序前端搭配SSM或SpringBoot后台框架开发环境为IDEA与微信开发者工具数据库使用MySQL 5.7配合Navicat管理部署基于Tomcat与Maven代码注释齐全新手也能看懂。压缩包共320个文件约44.85MB涵盖23个Java源文件、23个class、21个xml配置、32个js脚本、18个wxss与16个wxml页面文件以及jar依赖、png与jpg图片素材、sql数据库脚本等前后端代码与数据库脚本一应俱全。系统功能完善、界面美观、操作简单涵盖用户、悬赏、文章、上传与后台管理等模块经过严格调试可稳定运行下载后简单部署即可使用。目前已有45人学习下载适合需要快速搭建可运行项目、参考完整目录结构与排错思路的读者。1. 从一份「悬赏信息发布系统」压缩包说起它到底能跑出什么很多人拿到「微信小程序-悬赏信息发布系统(java)包括源码数据库教程.zip」这类压缩包第一反应是解压、找 README、双击启动类然后卡在数据库连不上或者小程序端请求 404。我见过太多人把这类项目当成「交作业模板」结果连本地跑通都做不到。它本质上是一套前后端分离的悬赏任务平台小程序端负责发布悬赏、浏览列表、接单、提交凭证Java 后端负责用户鉴权、任务状态流转、文件上传和数据库读写。适合谁适合想学微信小程序 Java 全栈落地的新手也适合需要快速搭一个任务撮合类 Demo 的熟手。这一章不聊虚的先把这套系统拆成能动手的模块后面几章按「环境怎么配、表怎么建、接口怎么写、坑怎么躲」的顺序推下去。2. 跑通前的环境与依赖JDK、MySQL、微信开发者工具怎么配2.1 后端运行环境的最小配置清单拿到源码后别急着改代码先把运行环境对齐。这套 Java 后端常见做法是 Spring Boot MyBatis-Plus数据库用 MySQL 5.7 或 8.0。我一般会先确认三件事JDK 版本、Maven 依赖能不能拉下来、MySQL 字符集是不是 utf8mb4。JDK 建议 1.8 或 11别上来就 JDK 17很多老项目的javax.*包在 17 里已经移除会直接报ClassNotFoundException。Maven 配置里把阿里云镜像加上否则拉依赖能等到怀疑人生。# 检查 JDK 版本确保是 1.8 或 11 java -version # 检查 Maven 是否可用 mvn -v # 登录 MySQL确认字符集 mysql -u root -p -e SHOW VARIABLES LIKE character_set%;上面三条命令分别验证 Java 运行时、构建工具和数据库字符集。java -version输出里如果看到17或21要么换 JDK要么在pom.xml里显式指定编译级别。mvn -v确认 Maven 能正常调用。最后一条 SQL 重点看character_set_server和character_set_database必须是utf8mb4否则中文悬赏标题会变成问号这个坑后面还会细说。2.2 数据库导入与连接串修改压缩包里一般会带一个.sql文件常见命名是db.sql或reward_system.sql。导入之前先建库别直接往mysql系统库里灌。建库语句要指定字符集和排序规则否则后面改起来很麻烦。-- 创建数据库字符集必须 utf8mb4 CREATE DATABASE reward_db DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; -- 切换到该库 USE reward_db; -- 导入表结构在命令行执行不在 SQL 客户端里 -- mysql -u root -p reward_db reward_system.sql建库时utf8mb4和utf8mb4_general_ci是固定搭配别用utf8那是 MySQL 里的历史遗留别名存 emoji 会失败。导入命令用重定向方式执行比在图形化工具里复制粘贴靠谱尤其是表多、数据量大的时候。导入完成后执行SHOW TABLES;确认表数量一般悬赏系统会有user、task、order、category、file这几张核心表。连接串在application.yml或application.properties里改。常见配置项是spring.datasource.url、username、password。URL 里要带useUnicodetruecharacterEncodingutf8serverTimezoneAsia/Shanghai少一个参数就可能出现时区差 8 小时或者中文乱码。spring: datasource: url: jdbc:mysql://localhost:3306/reward_db?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/Shanghai username: root password: 你的密码 driver-class-name: com.mysql.cj.jdbc.DriverserverTimezone不写会报The server time zone value ???ú±ê×??±?? is unrecognized这是 MySQL 8 驱动强制要求。driver-class-name用com.mysql.cj.jdbc.Driver别用老的com.mysql.jdbc.Driver后者在 8.0 驱动里已经废弃。改完配置先别启动继续看下一节的小程序端配置。2.3 微信开发者工具导入与合法域名处理小程序端用微信开发者工具打开项目目录一般叫miniprogram或wx-client。导入时填的 AppID 可以用测试号但测试号不支持真机预览部分能力。打开后第一件事是改app.js或config.js里的后端地址常见变量名是baseUrl或apiHost。// app.js 里修改后端请求地址 const config { baseUrl: http://localhost:8080/api, // 本地调试用 localhost timeout: 10000 };本地调试时baseUrl写http://localhost:8080没问题但微信开发者工具默认校验合法域名需要在「详情-本地设置」里勾选「不校验合法域名、web-view业务域名、TLS 版本以及 HTTPS 证书」。不勾的话所有请求都会报request:fail url not in domain list。真机预览时 localhost 不通得换成局域网 IP比如http://192.168.1.100:8080并且手机和电脑在同一 WiFi 下。这一步没有捷径我一般会在电脑上ipconfig或ifconfig查 IP然后填进去。3. 悬赏信息发布系统的核心表结构与接口设计3.1 五张核心表user、task、order、category、file数据库表结构决定了后端接口怎么写。这套系统常见做法是五张表打底字段不用照抄但关系要理清。下面这张表是我从多个类似项目里归纳的字段清单实际源码可能略有出入按这个思路去核对即可。表名关键字段作用userid, openid, nickname, avatar, phone, create_time存小程序用户openid 是微信唯一标识taskid, user_id, title, content, reward, status, category_id, create_time悬赏任务主表status 控制流转orderid, task_id, receiver_id, status, submit_time, confirm_time接单记录一个任务可有多人接单categoryid, name, sort任务分类前端下拉框数据源fileid, task_id, order_id, url, type存凭证图片或附件地址task表的status字段是状态机核心常见取值是0-待接单、1-进行中、2-待确认、3-已完成、4-已取消。order表的status类似但多一个receiver_id关联接单人。file表存的是文件访问路径不是二进制内容实际文件落在服务器磁盘或对象存储上。建表时给task.user_id、order.task_id、order.receiver_id加索引否则数据量上来后列表查询会全表扫描。3.2 发布悬赏接口从请求参数到落库的完整链路发布悬赏是小程序端最核心的写操作。前端传标题、内容、赏金、分类 ID后端校验登录态后插入task表。下面是一个典型的 Controller 方法用 Spring Boot 写法。PostMapping(/task/publish) public Result publishTask(RequestBody TaskPublishDTO dto, HttpServletRequest request) { // 从拦截器或 token 中解析当前用户 Long userId UserContext.getUserId(request); if (userId null) { return Result.fail(请先登录); } // 参数校验标题非空、赏金大于 0 if (dto.getTitle() null || dto.getTitle().trim().isEmpty()) { return Result.fail(标题不能为空); } if (dto.getReward() null || dto.getReward().compareTo(BigDecimal.ZERO) 0) { return Result.fail(赏金必须大于 0); } Task task new Task(); task.setUserId(userId); task.setTitle(dto.getTitle()); task.setContent(dto.getContent()); task.setReward(dto.getReward()); task.setCategoryId(dto.getCategoryId()); task.setStatus(0); // 0 表示待接单 task.setCreateTime(new Date()); taskService.save(task); return Result.success(task.getId()); }这段代码的关键点有三个UserContext.getUserId(request)从请求头或 session 里拿用户 ID具体实现看项目里的拦截器dto.getReward()用BigDecimal而不是double金额计算不能用浮点数task.setStatus(0)是硬编码初始状态别写成魔法数字实际项目里建议用枚举。参数校验只做了非空和正数判断生产环境还要加长度限制和敏感词过滤。返回结果里带task.getId()前端拿到后可以跳转到详情页。3.3 接单与状态流转避免超卖和重复接单接单接口比发布复杂因为要处理并发。两个人同时点「接单」不能都成功。常见做法是在order表上加唯一索引(task_id, receiver_id)或者用UPDATE task SET status 1 WHERE id ? AND status 0这种乐观锁。Transactional public Result acceptTask(Long taskId, Long receiverId) { // 原子更新只有 status0 的任务才能被接单 int updated taskMapper.updateStatus(taskId, 0, 1); if (updated 0) { return Result.fail(任务已被接单或状态不允许); } Order order new Order(); order.setTaskId(taskId); order.setReceiverId(receiverId); order.setStatus(1); // 进行中 order.setCreateTime(new Date()); orderMapper.insert(order); return Result.success(); }updateStatus对应的 SQL 是UPDATE task SET status 1 WHERE id #{taskId} AND status #{oldStatus}返回受影响行数。如果返回 0说明任务已经被别人抢先接单直接给前端提示。这个方案比先查再改可靠因为查和改之间有时间窗口。Transactional保证更新任务状态和插入订单记录在同一个事务里要么都成功要么都回滚。注意order表如果加了(task_id, receiver_id)唯一索引重复接单会抛DuplicateKeyException需要全局异常处理捕获后返回友好提示。4. 本地联调与接口验证Postman 和开发者工具怎么配合4.1 用 Postman 先验后端再调小程序后端启动后别急着开小程序先用 Postman 把接口跑一遍。登录接口一般需要传code后端拿 code 去微信服务器换 openid。本地调试时可以在后端加一个 mock 登录接口直接传 userId 返回 token省去每次拿 code 的麻烦。# 启动 Spring Boot 项目 mvn spring-boot:run # 或者打包后运行 mvn clean package -DskipTests java -jar target/reward-system-0.0.1-SNAPSHOT.jar启动日志里看到Started Application in x.x seconds才算成功。如果报Port 8080 was already in use改application.yml里的server.port或者杀掉占用端口的进程。Postman 里建一个环境变量baseUrl指向http://localhost:8080然后依次测登录、发布、列表、接单、上传。每个接口的返回结构要统一常见是{ code: 200, msg: success, data: {} }前端根据code判断成功失败。4.2 小程序端请求封装与 token 携带小程序端不要在每个页面里写wx.request封装一个request.js统一处理 baseUrl、token 和错误提示。// utils/request.js const app getApp(); function request(options) { const token wx.getStorageSync(token); return new Promise((resolve, reject) { wx.request({ url: app.globalData.baseUrl options.url, method: options.method || GET, data: options.data || {}, header: { content-type: application/json, Authorization: token ? Bearer token : }, success(res) { if (res.data.code 200) { resolve(res.data.data); } else if (res.data.code 401) { wx.navigateTo({ url: /pages/login/login }); reject(res.data); } else { wx.showToast({ title: res.data.msg, icon: none }); reject(res.data); } }, fail(err) { wx.showToast({ title: 网络异常, icon: none }); reject(err); } }); }); } module.exports { request };这段封装做了四件事自动拼接 baseUrl、从本地缓存取 token 放到请求头、统一处理 401 跳登录、统一 toast 错误信息。Authorization头用Bearer前缀后端拦截器解析时要去掉这个前缀。wx.getStorageSync(token)在登录成功后写入退出登录时清除。注意content-type用application/json如果后端用RequestParam接收表单数据这里要改成application/x-www-form-urlencoded否则参数收不到。5. 避坑与排查数据库乱码、跨域、文件上传失败5.1 中文乱码从数据库到响应体的三层排查现象发布悬赏后标题显示为???或悬èµ。原因通常有三层数据库字符集不是 utf8mb4、连接串没带 characterEncoding、响应体没设编码。解决顺序是从底往上查。先执行SHOW CREATE TABLE task;看表的字符集如果是latin1或utf8用ALTER TABLE task CONVERT TO CHARACTER SET utf8mb4;改。再检查连接串确认有characterEncodingutf8。最后看 Controller 返回时有没有produces application/json;charsetUTF-8Spring Boot 默认是 UTF-8但老项目可能配了StringHttpMessageConverter默认 ISO-8859-1。5.2 跨域报错开发者工具和真机的区别现象开发者工具里请求正常真机预览报request:fail或后端日志出现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)同时使用时不能用allowedOrigins(*)否则 Spring 会报错。maxAge(3600)表示预检请求缓存一小时减少 OPTIONS 请求次数。真机调试时还要确保手机和电脑在同一网段防火墙没拦 8080 端口。5.3 文件上传失败路径、大小和类型限制现象上传凭证图片时返回 500 或前端提示uploadFile:fail。常见原因有三个上传目录不存在、文件大小超过限制、文件类型没放行。后端配置里spring.servlet.multipart.max-file-size默认是 1MB手机拍的照片很容易超过改成 10MB 或 20MB。上传目录要提前建好代码里用File.mkdirs()确保存在。类型限制在MultipartFile的getContentType()里判断只允许image/jpeg、image/png。spring: servlet: multipart: max-file-size: 10MB max-request-size: 20MBmax-request-size要大于等于max-file-size否则多文件上传会失败。上传后的文件名用 UUID 重命名避免中文名和特殊字符导致路径问题。存储路径建议配成绝对路径相对路径在不同启动目录下会变。5.4 任务列表加载更多分页参数和前端触底现象小程序列表上拉加载更多时重复数据或没有数据。原因是分页参数page和pageSize没传对或者后端 SQL 的LIMIT偏移量算错。常见做法是前端维护pageNum从 1 开始每次触底加 1后端用LIMIT (pageNum-1)*pageSize, pageSize。返回结果里带total前端判断pageNum * pageSize total时停止加载。注意 MySQL 的LIMIT偏移量越大越慢数据量大时用WHERE id lastId LIMIT pageSize替代。6. 进阶技巧把悬赏系统改成可配置的状态机跑通之后如果想继续打磨我建议把task.status和order.status从硬编码数字改成枚举加状态机。这样新增状态比如「申诉中」「已退款」时不用满项目找if (status 2)。具体做法是定义一个TaskStatusEnum每个枚举值带code和desc再用一个MapInteger, TaskStatusEnum做缓存。状态流转时校验当前状态是否允许目标状态不允许就抛业务异常。public enum TaskStatusEnum { PENDING(0, 待接单), PROCESSING(1, 进行中), CONFIRMING(2, 待确认), FINISHED(3, 已完成), CANCELED(4, 已取消); private final int code; private final String desc; TaskStatusEnum(int code, String desc) { this.code code; this.desc desc; } private static final MapInteger, TaskStatusEnum CACHE new HashMap(); static { for (TaskStatusEnum e : values()) { CACHE.put(e.code, e); } } public static TaskStatusEnum of(int code) { return CACHE.get(code); } public int getCode() { return code; } public String getDesc() { return desc; } }用的时候TaskStatusEnum.of(task.getStatus())拿到枚举比较和展示都走枚举方法。状态流转校验可以写一个canTransferTo方法把允许的流转关系配在枚举里。这样前端下拉框的选项也能从后端接口动态获取不用写死。我自己的习惯是每接一个类似项目先把状态机画出来再写代码能省掉后面大量改 bug 的时间。这套悬赏系统看起来简单但状态流转和并发接单是最容易翻车的地方把这两块做扎实剩下的增删改查都是体力活。希望帮到你。本文还有配套的精品资源点击获取 微信小程序悬赏系统Java全栈实战：环境配置、接口设计与避坑指南
简介这是一套面向高校学生与Java初学者的微信小程序悬赏信息发布系统完整项目包适用于毕业设计、期末大作业与课程设计场景。项目采用小程序前端搭配SSM或SpringBoot后台框架开发环境为IDEA与微信开发者工具数据库使用MySQL 5.7配合Navicat管理部署基于Tomcat与Maven代码注释齐全新手也能看懂。压缩包共320个文件约44.85MB涵盖23个Java源文件、23个class、21个xml配置、32个js脚本、18个wxss与16个wxml页面文件以及jar依赖、png与jpg图片素材、sql数据库脚本等前后端代码与数据库脚本一应俱全。系统功能完善、界面美观、操作简单涵盖用户、悬赏、文章、上传与后台管理等模块经过严格调试可稳定运行下载后简单部署即可使用。目前已有45人学习下载适合需要快速搭建可运行项目、参考完整目录结构与排错思路的读者。1. 从一份「悬赏信息发布系统」压缩包说起它到底能跑出什么很多人拿到「微信小程序-悬赏信息发布系统(java)包括源码数据库教程.zip」这类压缩包第一反应是解压、找 README、双击启动类然后卡在数据库连不上或者小程序端请求 404。我见过太多人把这类项目当成「交作业模板」结果连本地跑通都做不到。它本质上是一套前后端分离的悬赏任务平台小程序端负责发布悬赏、浏览列表、接单、提交凭证Java 后端负责用户鉴权、任务状态流转、文件上传和数据库读写。适合谁适合想学微信小程序 Java 全栈落地的新手也适合需要快速搭一个任务撮合类 Demo 的熟手。这一章不聊虚的先把这套系统拆成能动手的模块后面几章按「环境怎么配、表怎么建、接口怎么写、坑怎么躲」的顺序推下去。2. 跑通前的环境与依赖JDK、MySQL、微信开发者工具怎么配2.1 后端运行环境的最小配置清单拿到源码后别急着改代码先把运行环境对齐。这套 Java 后端常见做法是 Spring Boot MyBatis-Plus数据库用 MySQL 5.7 或 8.0。我一般会先确认三件事JDK 版本、Maven 依赖能不能拉下来、MySQL 字符集是不是 utf8mb4。JDK 建议 1.8 或 11别上来就 JDK 17很多老项目的javax.*包在 17 里已经移除会直接报ClassNotFoundException。Maven 配置里把阿里云镜像加上否则拉依赖能等到怀疑人生。# 检查 JDK 版本确保是 1.8 或 11 java -version # 检查 Maven 是否可用 mvn -v # 登录 MySQL确认字符集 mysql -u root -p -e SHOW VARIABLES LIKE character_set%;上面三条命令分别验证 Java 运行时、构建工具和数据库字符集。java -version输出里如果看到17或21要么换 JDK要么在pom.xml里显式指定编译级别。mvn -v确认 Maven 能正常调用。最后一条 SQL 重点看character_set_server和character_set_database必须是utf8mb4否则中文悬赏标题会变成问号这个坑后面还会细说。2.2 数据库导入与连接串修改压缩包里一般会带一个.sql文件常见命名是db.sql或reward_system.sql。导入之前先建库别直接往mysql系统库里灌。建库语句要指定字符集和排序规则否则后面改起来很麻烦。-- 创建数据库字符集必须 utf8mb4 CREATE DATABASE reward_db DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; -- 切换到该库 USE reward_db; -- 导入表结构在命令行执行不在 SQL 客户端里 -- mysql -u root -p reward_db reward_system.sql建库时utf8mb4和utf8mb4_general_ci是固定搭配别用utf8那是 MySQL 里的历史遗留别名存 emoji 会失败。导入命令用重定向方式执行比在图形化工具里复制粘贴靠谱尤其是表多、数据量大的时候。导入完成后执行SHOW TABLES;确认表数量一般悬赏系统会有user、task、order、category、file这几张核心表。连接串在application.yml或application.properties里改。常见配置项是spring.datasource.url、username、password。URL 里要带useUnicodetruecharacterEncodingutf8serverTimezoneAsia/Shanghai少一个参数就可能出现时区差 8 小时或者中文乱码。spring: datasource: url: jdbc:mysql://localhost:3306/reward_db?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/Shanghai username: root password: 你的密码 driver-class-name: com.mysql.cj.jdbc.DriverserverTimezone不写会报The server time zone value ???ú±ê×??±?? is unrecognized这是 MySQL 8 驱动强制要求。driver-class-name用com.mysql.cj.jdbc.Driver别用老的com.mysql.jdbc.Driver后者在 8.0 驱动里已经废弃。改完配置先别启动继续看下一节的小程序端配置。2.3 微信开发者工具导入与合法域名处理小程序端用微信开发者工具打开项目目录一般叫miniprogram或wx-client。导入时填的 AppID 可以用测试号但测试号不支持真机预览部分能力。打开后第一件事是改app.js或config.js里的后端地址常见变量名是baseUrl或apiHost。// app.js 里修改后端请求地址 const config { baseUrl: http://localhost:8080/api, // 本地调试用 localhost timeout: 10000 };本地调试时baseUrl写http://localhost:8080没问题但微信开发者工具默认校验合法域名需要在「详情-本地设置」里勾选「不校验合法域名、web-view业务域名、TLS 版本以及 HTTPS 证书」。不勾的话所有请求都会报request:fail url not in domain list。真机预览时 localhost 不通得换成局域网 IP比如http://192.168.1.100:8080并且手机和电脑在同一 WiFi 下。这一步没有捷径我一般会在电脑上ipconfig或ifconfig查 IP然后填进去。3. 悬赏信息发布系统的核心表结构与接口设计3.1 五张核心表user、task、order、category、file数据库表结构决定了后端接口怎么写。这套系统常见做法是五张表打底字段不用照抄但关系要理清。下面这张表是我从多个类似项目里归纳的字段清单实际源码可能略有出入按这个思路去核对即可。表名关键字段作用userid, openid, nickname, avatar, phone, create_time存小程序用户openid 是微信唯一标识taskid, user_id, title, content, reward, status, category_id, create_time悬赏任务主表status 控制流转orderid, task_id, receiver_id, status, submit_time, confirm_time接单记录一个任务可有多人接单categoryid, name, sort任务分类前端下拉框数据源fileid, task_id, order_id, url, type存凭证图片或附件地址task表的status字段是状态机核心常见取值是0-待接单、1-进行中、2-待确认、3-已完成、4-已取消。order表的status类似但多一个receiver_id关联接单人。file表存的是文件访问路径不是二进制内容实际文件落在服务器磁盘或对象存储上。建表时给task.user_id、order.task_id、order.receiver_id加索引否则数据量上来后列表查询会全表扫描。3.2 发布悬赏接口从请求参数到落库的完整链路发布悬赏是小程序端最核心的写操作。前端传标题、内容、赏金、分类 ID后端校验登录态后插入task表。下面是一个典型的 Controller 方法用 Spring Boot 写法。PostMapping(/task/publish) public Result publishTask(RequestBody TaskPublishDTO dto, HttpServletRequest request) { // 从拦截器或 token 中解析当前用户 Long userId UserContext.getUserId(request); if (userId null) { return Result.fail(请先登录); } // 参数校验标题非空、赏金大于 0 if (dto.getTitle() null || dto.getTitle().trim().isEmpty()) { return Result.fail(标题不能为空); } if (dto.getReward() null || dto.getReward().compareTo(BigDecimal.ZERO) 0) { return Result.fail(赏金必须大于 0); } Task task new Task(); task.setUserId(userId); task.setTitle(dto.getTitle()); task.setContent(dto.getContent()); task.setReward(dto.getReward()); task.setCategoryId(dto.getCategoryId()); task.setStatus(0); // 0 表示待接单 task.setCreateTime(new Date()); taskService.save(task); return Result.success(task.getId()); }这段代码的关键点有三个UserContext.getUserId(request)从请求头或 session 里拿用户 ID具体实现看项目里的拦截器dto.getReward()用BigDecimal而不是double金额计算不能用浮点数task.setStatus(0)是硬编码初始状态别写成魔法数字实际项目里建议用枚举。参数校验只做了非空和正数判断生产环境还要加长度限制和敏感词过滤。返回结果里带task.getId()前端拿到后可以跳转到详情页。3.3 接单与状态流转避免超卖和重复接单接单接口比发布复杂因为要处理并发。两个人同时点「接单」不能都成功。常见做法是在order表上加唯一索引(task_id, receiver_id)或者用UPDATE task SET status 1 WHERE id ? AND status 0这种乐观锁。Transactional public Result acceptTask(Long taskId, Long receiverId) { // 原子更新只有 status0 的任务才能被接单 int updated taskMapper.updateStatus(taskId, 0, 1); if (updated 0) { return Result.fail(任务已被接单或状态不允许); } Order order new Order(); order.setTaskId(taskId); order.setReceiverId(receiverId); order.setStatus(1); // 进行中 order.setCreateTime(new Date()); orderMapper.insert(order); return Result.success(); }updateStatus对应的 SQL 是UPDATE task SET status 1 WHERE id #{taskId} AND status #{oldStatus}返回受影响行数。如果返回 0说明任务已经被别人抢先接单直接给前端提示。这个方案比先查再改可靠因为查和改之间有时间窗口。Transactional保证更新任务状态和插入订单记录在同一个事务里要么都成功要么都回滚。注意order表如果加了(task_id, receiver_id)唯一索引重复接单会抛DuplicateKeyException需要全局异常处理捕获后返回友好提示。4. 本地联调与接口验证Postman 和开发者工具怎么配合4.1 用 Postman 先验后端再调小程序后端启动后别急着开小程序先用 Postman 把接口跑一遍。登录接口一般需要传code后端拿 code 去微信服务器换 openid。本地调试时可以在后端加一个 mock 登录接口直接传 userId 返回 token省去每次拿 code 的麻烦。# 启动 Spring Boot 项目 mvn spring-boot:run # 或者打包后运行 mvn clean package -DskipTests java -jar target/reward-system-0.0.1-SNAPSHOT.jar启动日志里看到Started Application in x.x seconds才算成功。如果报Port 8080 was already in use改application.yml里的server.port或者杀掉占用端口的进程。Postman 里建一个环境变量baseUrl指向http://localhost:8080然后依次测登录、发布、列表、接单、上传。每个接口的返回结构要统一常见是{ code: 200, msg: success, data: {} }前端根据code判断成功失败。4.2 小程序端请求封装与 token 携带小程序端不要在每个页面里写wx.request封装一个request.js统一处理 baseUrl、token 和错误提示。// utils/request.js const app getApp(); function request(options) { const token wx.getStorageSync(token); return new Promise((resolve, reject) { wx.request({ url: app.globalData.baseUrl options.url, method: options.method || GET, data: options.data || {}, header: { content-type: application/json, Authorization: token ? Bearer token : }, success(res) { if (res.data.code 200) { resolve(res.data.data); } else if (res.data.code 401) { wx.navigateTo({ url: /pages/login/login }); reject(res.data); } else { wx.showToast({ title: res.data.msg, icon: none }); reject(res.data); } }, fail(err) { wx.showToast({ title: 网络异常, icon: none }); reject(err); } }); }); } module.exports { request };这段封装做了四件事自动拼接 baseUrl、从本地缓存取 token 放到请求头、统一处理 401 跳登录、统一 toast 错误信息。Authorization头用Bearer前缀后端拦截器解析时要去掉这个前缀。wx.getStorageSync(token)在登录成功后写入退出登录时清除。注意content-type用application/json如果后端用RequestParam接收表单数据这里要改成application/x-www-form-urlencoded否则参数收不到。5. 避坑与排查数据库乱码、跨域、文件上传失败5.1 中文乱码从数据库到响应体的三层排查现象发布悬赏后标题显示为???或悬èµ。原因通常有三层数据库字符集不是 utf8mb4、连接串没带 characterEncoding、响应体没设编码。解决顺序是从底往上查。先执行SHOW CREATE TABLE task;看表的字符集如果是latin1或utf8用ALTER TABLE task CONVERT TO CHARACTER SET utf8mb4;改。再检查连接串确认有characterEncodingutf8。最后看 Controller 返回时有没有produces application/json;charsetUTF-8Spring Boot 默认是 UTF-8但老项目可能配了StringHttpMessageConverter默认 ISO-8859-1。5.2 跨域报错开发者工具和真机的区别现象开发者工具里请求正常真机预览报request:fail或后端日志出现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)同时使用时不能用allowedOrigins(*)否则 Spring 会报错。maxAge(3600)表示预检请求缓存一小时减少 OPTIONS 请求次数。真机调试时还要确保手机和电脑在同一网段防火墙没拦 8080 端口。5.3 文件上传失败路径、大小和类型限制现象上传凭证图片时返回 500 或前端提示uploadFile:fail。常见原因有三个上传目录不存在、文件大小超过限制、文件类型没放行。后端配置里spring.servlet.multipart.max-file-size默认是 1MB手机拍的照片很容易超过改成 10MB 或 20MB。上传目录要提前建好代码里用File.mkdirs()确保存在。类型限制在MultipartFile的getContentType()里判断只允许image/jpeg、image/png。spring: servlet: multipart: max-file-size: 10MB max-request-size: 20MBmax-request-size要大于等于max-file-size否则多文件上传会失败。上传后的文件名用 UUID 重命名避免中文名和特殊字符导致路径问题。存储路径建议配成绝对路径相对路径在不同启动目录下会变。5.4 任务列表加载更多分页参数和前端触底现象小程序列表上拉加载更多时重复数据或没有数据。原因是分页参数page和pageSize没传对或者后端 SQL 的LIMIT偏移量算错。常见做法是前端维护pageNum从 1 开始每次触底加 1后端用LIMIT (pageNum-1)*pageSize, pageSize。返回结果里带total前端判断pageNum * pageSize total时停止加载。注意 MySQL 的LIMIT偏移量越大越慢数据量大时用WHERE id lastId LIMIT pageSize替代。6. 进阶技巧把悬赏系统改成可配置的状态机跑通之后如果想继续打磨我建议把task.status和order.status从硬编码数字改成枚举加状态机。这样新增状态比如「申诉中」「已退款」时不用满项目找if (status 2)。具体做法是定义一个TaskStatusEnum每个枚举值带code和desc再用一个MapInteger, TaskStatusEnum做缓存。状态流转时校验当前状态是否允许目标状态不允许就抛业务异常。public enum TaskStatusEnum { PENDING(0, 待接单), PROCESSING(1, 进行中), CONFIRMING(2, 待确认), FINISHED(3, 已完成), CANCELED(4, 已取消); private final int code; private final String desc; TaskStatusEnum(int code, String desc) { this.code code; this.desc desc; } private static final MapInteger, TaskStatusEnum CACHE new HashMap(); static { for (TaskStatusEnum e : values()) { CACHE.put(e.code, e); } } public static TaskStatusEnum of(int code) { return CACHE.get(code); } public int getCode() { return code; } public String getDesc() { return desc; } }用的时候TaskStatusEnum.of(task.getStatus())拿到枚举比较和展示都走枚举方法。状态流转校验可以写一个canTransferTo方法把允许的流转关系配在枚举里。这样前端下拉框的选项也能从后端接口动态获取不用写死。我自己的习惯是每接一个类似项目先把状态机画出来再写代码能省掉后面大量改 bug 的时间。这套悬赏系统看起来简单但状态流转和并发接单是最容易翻车的地方把这两块做扎实剩下的增删改查都是体力活。希望帮到你。本文还有配套的精品资源点击获取