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

简介：面向高校场景的二手书交易系统完整工程，采用SpringCloud 2.3微服务拆分，涵盖用户管理、图书发布、书友圈互动、购物车与订单处理五大独立服务，全部基于SpringBoot 2.3 + MyBatis开发。服务注册与配置统一由Nacos支撑，网关层使用Spring Cloud Gateway做路由转发，服务间调用通过Feign实现。支付对接支付宝沙箱环境，图片及文件上传集成MinIO对象存储。提供开箱即用的Docker部署方案：包含MySQL 5.7容器、Nginx反向代理配置（附nginx.conf）、Nacos服务发现容器、各Java微服务镜像构建脚本（Dockerfile）及docker-compose.yml编排文件，支持单机快速启动或云服务器部署。配套交付数据库初始化SQL（按user/club/book/cart/order分库）、系统架构图、核心流程图、Markdown格式项目说明文档、UI参考配置及minio.sh部署辅助脚本。适用于计算机专业课程设计、毕业设计选题或SpringCloud技术实践，代码结构清晰、关键逻辑均有注释，可直接运行验证全流程功能，也便于按需扩展模块或替换技术组件。

1. 项目概述：为什么一个校园二手书平台，值得用微服务重做一遍？

你有没有在期末前疯狂找《数据结构与算法分析》的二手教材？有没有加过学校QQ群，只为蹲一本绝版的《编译原理》实验指导书？有没有在朋友圈发过“求《信号与系统》笔记，有偿”？这些真实、高频、轻量但又带着强烈校园社交属性的需求，恰恰是检验微服务落地能力的绝佳沙盒——它不追求千万级并发，但要求模块边界清晰、协作逻辑可追溯、部署升级不牵一发而动全身。我带过三届毕业设计，每年都有学生拿单体SpringBoot写个“二手书小站”，结果到答辩前一周卡在“用户登录后订单状态刷不出来”上，查日志发现是购物车和订单共用一张表，事务锁死整个库存模块。后来我们干脆把这套系统彻底重构为标准微服务架构，不是为了炫技，而是让每个模块真正“各司其职”：用户服务只管账号密码、实名认证、积分变动；图书服务专注ISBN校验、封面OCR识别（预留接口）、多维度检索；书友圈服务处理点赞评论、话题标签、消息通知；购物车服务维护会话级临时数据，不碰数据库持久化；订单服务才真正发起分布式事务，协调库存扣减、支付回调、物流单号生成。整套系统基于SpringCloud 2.3（对应SpringBoot 2.3.x），这个版本虽非最新，却是高校教学环境最稳妥的选择——JDK8兼容性好、依赖冲突少、文档资料全，连IDEA社区版都能无压力调试。所有服务均采用MyBatis而非JPA，原因很实在：课程设计阶段学生更熟悉SQL，手写Mapper XML能清晰看到每条查询背后的执行计划，避免JPA懒加载陷阱导致N+1查询拖垮MySQL。关键词里反复出现的“Docker部署”，不是为了赶时髦，而是解决最痛的交付问题：学生交作业时，光是“请先安装MySQL 5.7并创建5个库、配置Nacos集群、启动6个Java进程、修改8处application.yml里的IP地址”这一段说明，就能劝退一半人。我们把所有环境依赖打包进docker-compose.yml，执行一条docker-compose up -d，120秒内全部服务就绪，连Nginx反向代理都自动把gateway:8080映射到宿主机80端口，浏览器打开localhost就能看到首页。这不是玩具项目，而是把企业级工程实践压缩进校园场景的真实切片——它不教你怎么造火箭，但确保你亲手拧紧每一颗螺丝后，整辆车能稳稳跑起来。

2. 架构设计与技术选型：为什么是这套组合，而不是其他方案？

2.1 微服务拆分逻辑：五个服务如何定义边界？

很多初学者以为“拆成多个模块就是微服务”，结果拆完发现user-service要查book-service的库存，book-service又要调order-service确认是否已下单，最后形成服务网状调用，一个节点故障引发雪崩。我们的拆分严格遵循“单一职责+业务内聚”原则，每个服务的数据存储、业务逻辑、对外接口完全自治：

• user-service：仅处理身份相关操作。注册/登录走JWT鉴权，密码用BCrypt加密；实名认证对接学校教务系统API（模拟返回学号+院系）；积分变动通过RabbitMQ异步通知书友圈服务（如发帖获10分）。关键点在于：它不存任何图书信息，连用户收藏夹都放在book-service里，只存一个user_id外键。
• book-service：图书全生命周期管理。发布新书时强制校验ISBN13格式（正则^978[0-9]{10}$|^979[0-9]{10}$），调用国家新闻出版署公开API验证书名真实性（开发时用mock数据，生产可替换）；封面上传走MinIO，返回预签名URL供前端直传，避免服务端中转大文件；检索支持按ISBN、书名模糊匹配、作者、院系标签（如“计算机学院推荐”）三级过滤，底层用Elasticsearch（Docker镜像已集成）。
• club-service：校园社交属性核心。帖子按“教材求助”“笔记共享”“考试经验”打标签，评论支持@同学（解析文本中的@xxx触发站内信）；消息通知用WebSocket长连接，但离线消息存入MySQL的notice表，登录时拉取未读。这里刻意没做“关注”功能——校园场景下用户关系链极短，强行做图计算反而增加复杂度。
• cart-service：无状态会话服务。购物车数据存在Redis，key设计为cart:{user_id}，value为JSON数组，每项含book_id、quantity、selected（是否勾选结算）。为什么不用数据库？因为期末抢购《操作系统》教材时，瞬时并发可能达500+/秒，Redis原子操作比MySQL行锁更扛压。结算时只传递book_id列表给order-service，自身不参与后续流程。
• order-service：唯一承担分布式事务的服务。创建订单时，先调用book-service扣减库存（Feign同步调用，超时设为800ms），再调用user-service校验余额（异步消息补偿），最后调支付宝沙箱生成支付链接。若任一环节失败，通过本地消息表+定时任务实现最终一致性，而非强一致XA协议——对二手书交易而言，“稍晚几秒显示支付成功”远比“系统卡死”更可接受。

提示：所有服务间通信必须通过Feign Client，禁止直接HTTP调用。我们在feign-api模块统一定义接口，例如BookClient.java里声明GET /books/{isbn}方法，各服务引入该jar包即可调用，避免重复编写RestTemplate代码，也便于后期统一添加熔断降级逻辑。

2.2 注册与配置中心：为什么选Nacos而不选Eureka或Consul？

Nacos在SpringCloud 2.3生态中已是事实标准，但选择它还有三个硬核理由：

1. 配置热更新零感知：比如调整book-service的ES检索超时时间，只需在Nacos控制台修改book-service-dev.yaml里的elasticsearch.timeout: 3000，服务无需重启，10秒内自动生效。对比Eureka需重启实例才能加载新配置，这对需要频繁调试的学生太友好。
2. 服务健康检查更精准：Nacos默认用TCP探测（检测端口是否存活），但我们改成了HTTP探针，指向/actuator/health端点。这样当book-service因ES连接池耗尽导致检索失败时，Nacos能立即剔除该实例，避免gateway把流量继续导过去。
3. 命名空间隔离实战价值高：在dev命名空间下运行测试环境，在prod命名空间部署演示环境，两者配置完全独立。学生做课程设计时，可直接fork项目，在自己GitHub仓库建student-xxx命名空间，避免误改公共配置。

注意：Nacos集群模式虽稳定，但课程设计场景用单机版足够。Docker Compose里我们只启一个nacos容器，通过-e MODE=standalone参数启动，内存占用仅512MB，学生笔记本也能流畅运行。

2.3 网关与路由：Gateway如何解决跨域与权限前置？

Spring Cloud Gateway不是简单的反向代理，它是整个系统的流量入口守门员。我们的配置聚焦三个刚需：

• 动态路由：gateway/src/main/resources/application.yml中定义：
  yaml spring: cloud: gateway: routes: - id: user-service uri: lb://user-service predicates: - Path=/api/user/** filters: - StripPrefix=2 # 去掉/api前缀再转发 - id: book-service uri: lb://book-service predicates: - Path=/api/book/** filters: - StripPrefix=2
  这样前端所有请求都走http://localhost/api/user/login，Gateway自动识别路径前缀，负载均衡到对应服务实例，学生调试时不用记一堆IP+端口。

• 全局CORS配置：针对Vue前端跨域问题，在GlobalCorsConfig.java中设置：
  java @Bean public CorsConfigurationSource corsConfigurationSource() { CorsConfiguration configuration = new CorsConfiguration(); configuration.setAllowedOrigins(Arrays.asList("http://localhost:8080", "http://127.0.0.1:8080")); configuration.setAllowedMethods(Arrays.asList("GET","POST","PUT","DELETE","OPTIONS")); configuration.setAllowCredentials(true); UrlBasedCorsConfigurationSource source = new UrlBasedCorsConfigurationSource(); source.registerCorsConfiguration("/**", configuration); return source; }
  关键点在于setAllowCredentials(true)必须配合allowedOrigins指定具体域名，不能用*，否则浏览器会拒绝携带Cookie。

• JWT鉴权前置：所有/api/**路径请求，Gateway先解析Header里的Authorization: Bearer xxx，校验JWT签名及有效期，验证通过才放行，否则直接返回401。这样user-service等下游服务无需重复鉴权逻辑，专注业务本身。

3. 核心模块实现细节：从代码到部署的关键实操要点

3.1 支付模块：支付宝沙箱如何安全接入？

支付宝沙箱不是“随便填个appid就能用”，实际踩坑最多的是证书配置和异步通知。我们采用RSA2非对称加密，步骤如下：

1. 生成密钥对：用OpenSSL命令生成2048位密钥：
   bash openssl genrsa -out app_private_key.pem 2048 openssl rsa -in app_private_key.pem -pubout -out app_public_key.pem
   将app_public_key.pem内容粘贴到支付宝沙箱后台“开放平台->密钥管理”，获取支付宝公钥。

2. 代码层封装：在order-service的AlipayService.java中，使用alipay-sdk-java 4.39.12.ALL.jar（此版本兼容JDK8）：
   java AlipayClient alipayClient = new DefaultAlipayClient( "https://openapi.alipaydev.com/gateway.do", // 沙箱网关 "2021000123456789", // 沙箱APPID "MIIEvQIBADANBgkqhkiG9w0BAQEFAASCBKcwggSjAgEAAoIBAQ...", // 应用私钥（PKCS#8格式） "json", "UTF-8", "MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA...", // 支付宝公钥 "RSA2" );

3. 异步通知防重放：支付宝会多次POST通知到/api/order/notify，必须校验sign参数且记录out_trade_no去重。我们在MySQL建alipay_notify_log表，每次收到通知先查是否存在相同trade_no，存在则直接返回success，避免重复发货。

实操心得：沙箱支付成功后，支付宝不会自动跳转回页面，需在前端调用alipay.trade.page.pay接口后，用window.location.href = result.body跳转到支付页。学生常犯错误是把result.body当字符串打印，其实它是XML格式，需解析<body>标签内的URL。

3.2 文件上传：MinIO如何替代传统FTP？

MinIO的优势在于：轻量（单二进制文件）、S3协议兼容、控制台直观。但学生部署时90%失败在Endpoint配置：

• Docker启动MinIO：docker-compose.yml中定义：
  ```yaml
  minio:
  image: minio/minio:RELEASE.2023-03-20T20-16-18Z
  ports:

  • “9000:9000”
  • “9001:9001”
    environment:
    MINIO_ROOT_USER: minioadmin
    MINIO_ROOT_PASSWORD: minioadmin
    command: server /data –console-address “:9001”
    volumes:
  • ./minio-data:/data
    `` 关键点：–console-address “:9001”暴露Web控制台，访问http://localhost:9001`用上述账号登录。

• 前端直传实现：book-service提供POST /api/book/upload接口，返回预签名URL：
  java @PostMapping("/upload") public R<String> getPresignedUrl(@RequestParam String fileName) { String bucketName = "book-images"; String objectName = "covers/" + System.currentTimeMillis() + "_" + fileName; // 生成7天有效URL GeneratePresignedUrlRequest req = new GeneratePresignedUrlRequest(bucketName, objectName) .withMethod(HttpMethod.PUT) .withExpiration(Date.from(Instant.now().plus(7, ChronoUnit.DAYS))); URL url = minioClient.generatePresignedUrl(req); return R.success(url.toString()); }
  前端拿到URL后，用fetch(url, {method:'PUT', body:file})直传，全程不经过Java服务，节省带宽。

注意：MinIO默认创建的bucket是私有的，需在控制台手动设置book-images桶的策略为public-read，否则前端无法读取图片。

3.3 Docker一键部署：docker-compose.yml的隐藏技巧

学生最常问：“为什么docker-compose up后MySQL连不上？”答案往往藏在配置细节里：

version: '3.8'
services:
  mysql:
    image: mysql:5.7
    restart: always
    environment:
      MYSQL_ROOT_PASSWORD: root123
      MYSQL_DATABASE: book_platform
    volumes:
      - ./mysql-data:/var/lib/mysql
      - ./hmy.cnf:/etc/mysql/conf.d/hmy.cnf # 关键！解决中文乱码
    ports:
      - "3306:3306"

  nginx:
    image: nginx:alpine
    ports:
      - "80:80"
    volumes:
      - ./nginx.conf:/etc/nginx/nginx.conf
      - ./index.html:/usr/share/nginx/html/index.html
    depends_on:
      - gateway

  gateway:
    build: ./gateway
    environment:
      - SPRING_PROFILES_ACTIVE=dev
      - NACOS_SERVER_ADDR=nacos:8848
    depends_on:
      - nacos
      - mysql

  nacos:
    image: nacos/nacos-server:v2.0.3
    environment:
      - MODE=standalone
      - JVM_XMS=512m
      - JVM_XMX=512m
    ports:
      - "8848:8848"

• hmy.cnf解决字符集：内容为：
  ini [client] default-character-set = utf8mb4 [mysql] default-character-set = utf8mb4 [mysqld] character-set-server = utf8mb4 collation-server = utf8mb4_unicode_ci init_connect='SET NAMES utf8mb4' skip-character-set-client-handshake = true
  若不挂载此文件，MySQL容器内默认latin1，存中文变问号。

• depends_on不是等待就绪：depends_on只保证容器启动顺序，不等MySQL初始化完成。我们在gateway/Dockerfile中加入健康检查：
  dockerfile HEALTHCHECK --interval=30s --timeout=3s --start-period=5s --retries=3 \ CMD curl -f http://mysql:3306 || exit 1
  这样gateway启动前会循环检测MySQL端口，直到响应才继续。

• Nginx反向代理配置：nginx.conf核心段：
  nginx upstream gateway { server gateway:8080; } server { listen 80; location /api/ { proxy_pass http://gateway; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; } location / { root /usr/share/nginx/html; try_files $uri $uri/ /index.html; } }
  关键点：proxy_pass http://gateway中的gateway必须与docker-compose里服务名一致，且不带端口号（Docker内部DNS自动解析）。

4. 全流程部署实录：从空服务器到可演示系统

4.1 本地开发环境快速启动（Windows/Mac/Linux通用）

假设你已安装Docker Desktop（Mac/Win）或Docker Engine（Linux），执行以下步骤：

1. 克隆项目并进入目录：
   bash git clone https://github.com/xxx/yn93nQEfXNR2JPuQNvGv-master.git cd yn93nQEfXNR2JPuQNvGv-master

2. 初始化MySQL数据：
   执行data/init.sql脚本（含5个库的建库语句及基础数据）。若用Docker MySQL，可直接导入：
   bash docker exec -i mysql mysql -uroot -proot123 < data/init.sql

3. 构建Java服务镜像：
   项目根目录下执行：
   bash # 编译所有模块（需JDK8+Maven3.6+） mvn clean package -Dmaven.test.skip=true # 构建gateway镜像（其他服务同理） cd gateway && docker build -t gateway . cd ../user-service && docker build -t user-service . # ... 依次构建book/cart/order/club服务

4. 启动全栈服务：
   在项目根目录执行：
   bash docker-compose up -d
   等待约90秒，执行docker-compose ps查看状态，所有服务应为Up。

5. 验证服务连通性：
   - 访问http://localhost，看到首页即Nginx生效
   - 访问http://localhost:8848/nacos，账号nacos/nacos登录，查看服务列表是否全绿
   - 调用API测试：curl http://localhost/api/user/login -X POST -d '{"username":"test","password":"123"}'，返回JWT token即成功

实操心得：首次启动若gateway报错“nacos not found”，别急着删容器，执行docker network inspect yn93nqefxn_default确认所有容器在同一网络，再docker-compose restart gateway。这是Docker DNS缓存导致的常见延迟。

4.2 云服务器部署避坑指南（以腾讯云CentOS7为例）

云服务器部署比本地多三道坎：端口安全组、域名解析、HTTPS证书。

• 安全组配置：
  登录腾讯云控制台，在“云服务器->安全组”中，添加入站规则：
  | 协议端口 | 源IP | 描述 |
  |----------|------|------|
  | TCP:80 | 0.0.0.0/0 | Nginx HTTP |
  | TCP:443 | 0.0.0.0/0 | Nginx HTTPS（后续启用） |
  | TCP:8848 | 你的IP | Nacos控制台（限制访问IP更安全） |

• 域名绑定与HTTPS：
  购买域名（如book.yourname.com）后，在DNS解析中添加A记录指向云服务器公网IP。然后用Certbot申请免费证书：
  bash # 安装certbot yum install epel-release -y && yum install certbot python3-certbot-nginx -y # 获取证书（需先停Nginx） systemctl stop nginx certbot certonly --standalone -d book.yourname.com # 证书位置：/etc/letsencrypt/live/book.yourname.com/{fullchain.pem,privkey.pem}
  修改nginx.conf启用HTTPS：
  nginx server { listen 443 ssl; server_name book.yourname.com; ssl_certificate /etc/letsencrypt/live/book.yourname.com/fullchain.pem; ssl_certificate_key /etc/letsencrypt/live/book.yourname.com/privkey.pem; # 其余配置同HTTP段 }

• MySQL远程访问：
  默认MySQL只允许localhost连接，需授权：
  sql CREATE USER 'root'@'%' IDENTIFIED BY 'root123'; GRANT ALL PRIVILEGES ON *.* TO 'root'@'%' WITH GRANT OPTION; FLUSH PRIVILEGES;
  并在/etc/my.cnf中注释bind-address = 127.0.0.1，重启MySQL。

4.3 数据库SQL脚本详解：为什么分库而不共用一个库？

data/目录下有5个SQL文件：user.sql、book.sql、club.sql、cart.sql、order.sql，分别对应各服务的独立数据库。这种设计不是过度设计，而是为未来扩展埋点：

数据库	表数量	主要用途	分库理由
user_db	4张	users, roles, permissions, user_integral	用户积分与权限体系需高一致性，单独库便于读写分离
book_db	6张	books, categories, authors, publishers, book_images, book_tags	图书元数据变更频繁，独立库避免影响订单事务
club_db	3张	posts, comments, notices	社交数据量大但一致性要求低，可单独做归档表
cart_db	1张	carts	Redis已承担主要存储，MySQL仅存历史快照，极轻量
order_db	5张	orders, order_items, payments, logistics, refunds	订单涉及资金，必须独立库满足金融级审计要求

提示：init.sql是总入口脚本，内容为：
sql CREATE DATABASE IF NOT EXISTS user_db CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; CREATE DATABASE IF NOT EXISTS book_db CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; -- ... 创建其余库 SOURCE user.sql; SOURCE book.sql; -- ... 导入各库脚本
学生执行时只需运行init.sql，无需逐个导入。

5. 教学适配与二次开发：如何把这个项目变成你的毕业设计？

5.1 课程设计改造清单（2周内可完成）

针对不同课程目标，提供最小改动方案：

• 《SpringBoot应用开发》课设：
  保留全部微服务，但将club-service简化为纯CRUD（去掉WebSocket通知），重点实现：
  ✅ 用户发帖/评论的RESTful接口（POST /api/posts, GET /api/posts/{id}/comments）
  ✅ 前端用Thymeleaf渲染，不引入Vue
  ✅ 数据库用H2内存库，避免部署MySQL

• 《分布式系统》课设：
  强化分布式事务，改造order-service：
  ✅ 集成Seata AT模式，实现“扣库存-减积分-生成订单”三阶段提交
  ✅ 在book-service中模拟库存不足异常，观察Seata如何回滚已扣减的积分
  ✅ 对比Saga模式（用消息队列）与AT模式的优劣，写进报告

• 《软件工程》课设：
  补充全流程文档：
  ✅ 用PlantUML重绘系统架构图.md，标注各服务间调用关系
  ✅ 编写需求规格说明书.md，用用例图描述“学生发布教材”“教师审核上架”等角色场景
  ✅ 在pom.xml中添加JaCoCo插件，生成单元测试覆盖率报告（要求>65%）

5.2 毕业设计升级路径（3个月深度拓展）

若作为毕设课题，建议从三个方向深化，避免沦为“复制粘贴”：

• 智能推荐引擎：
  在book-service中新增RecommendService，基于协同过滤算法：
  ▪ 收集用户行为日志（浏览/收藏/购买），存入Elasticsearch
  ▪ 用Python训练LightFM模型（Docker单独启一个python服务），输入用户ID输出ISBN列表
  ▪ 通过Feign调用推荐服务，首页“猜你喜欢”板块展示结果
  ▪ 创新点：结合校园场景，给同院系用户更高权重（如计算机学院学生看《算法导论》后，优先推荐《机器学习》）

• 区块链存证：
  针对二手书交易纠纷，用Hyperledger Fabric记录关键操作：
  ▪ 将“图书上架”“订单创建”“支付成功”事件哈希值上链
  ▪ 在order-service中调用Fabric SDK，写入channel book-trace
  ▪ 前端提供“交易溯源”按钮，输入订单号查询链上存证
  ▪ 创新点：设计轻量级Fabric网络（1Orderer+2Peer），避免资源浪费

• 移动端适配：
  用Flutter重写前端，打通微信小程序：
  ▪ 复用现有RESTful API，无需改动Java服务
  ▪ 在gateway中新增/api/wx/login接口，对接微信开放平台获取unionId
  ▪ 用flutter_wechat_assets_picker实现图片多选上传至MinIO
  ▪ 创新点：利用微信社交关系链，实现“好友在卖《数据库》”的精准推送

5.3 常见问题速查表（学生高频提问TOP10）

问题现象	根本原因	解决方案	经验备注
Nacos控制台打不开	Docker内存不足或端口被占	docker system prune -a清理旧镜像；netstat -ano \| findstr :8848查占用进程	Mac用户注意Docker Desktop内存分配至少2GB
网关404所有接口	application.yml中spring.cloud.gateway.routes路径配置错误	检查predicates的Path值是否带/api/**前缀，StripPrefix数值是否匹配	前端请求URL必须与Gateway路由前缀完全一致
支付宝回调失败	沙箱域名未配置白名单	登录支付宝沙箱后台，进入“应用详情->开发信息”，将云服务器IP加入“授权回调地址”	本地调试用ngrok生成临时域名
MinIO上传403 Forbidden	桶策略未设为public-read	登录http://localhost:9001，点击对应bucket→Settings→Bucket Policy→编辑为{"Version":"2012-10-17","Statement":[{"Effect":"Allow","Principal":{"AWS":["*"]},"Action":["s3:GetObject"],"Resource":["arn:aws:s3:::book-images/*"]}]}
Docker启动MySQL报错“Can’t open the mysql.plugin table”	./mysql-data目录残留旧数据	删除该目录，重新执行docker-compose up	切勿直接rm -rf mysql-data，先docker-compose down停止容器
Feign调用超时	默认ReadTimeout=60秒，但book-service检索ES可能超时	在application.yml中增加：feign.client.config.default.read-timeout: 10000	生产环境建议设为5秒，超时后走降级逻辑
Nginx静态资源404	nginx.conf中root路径错误	确认./index.html文件存在，且root指向/usr/share/nginx/html	Docker内路径与宿主机路径必须严格对应
用户登录后JWT失效	Gateway未正确传递Authorization头	检查GlobalFilter是否遗漏exchange.getRequest().mutate().headers(h -> h.set("Authorization", token))	JWT必须在Gateway层解析并透传，下游服务不再解析
购物车数据不持久	Redis未配置持久化，Docker重启后丢失	在redis.conf中设置save 60 1000（60秒内1000次修改则保存）	课程设计可忽略，毕设需补充RDB/AOF双备份
IDEA调试时找不到类	Maven模块未正确导入	右键项目→Maven→Reload project；检查pom.xml中<modules>是否包含所有子模块	feign-api模块必须先install到本地仓库

最后分享一个小技巧：所有服务的application-dev.yml中，数据库URL统一写成jdbc:mysql://mysql:3306/${db.name}?useUnicode=true&characterEncoding=UTF-8，其中mysql是Docker内部服务名，而非localhost。这是Docker网络通信的基础，也是学生最容易写错的地方——本地调试时用localhost没问题，但一旦打包进Docker，localhost就指向容器自身，而非MySQL容器。

这个校园二手书平台，从来不只是一个代码包。它是把企业级架构思想，揉碎了喂给学生的消化片；是把分布式事务、服务治理、容器化部署这些抽象概念，具象成可触摸、可调试、可演示的实体。当你在答辩现场，用手机扫一下二维码，实时下单一本《计算机网络》，后台订单服务弹出“支付成功”，而这一切背后是六个Docker容器在协同工作——那一刻，你交付的不再是作业，而是工程师思维的第一次成型。

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

简介：面向高校场景的二手书交易系统完整工程，采用SpringCloud 2.3微服务拆分，涵盖用户管理、图书发布、书友圈互动、购物车与订单处理五大独立服务，全部基于SpringBoot 2.3 + MyBatis开发。服务注册与配置统一由Nacos支撑，网关层使用Spring Cloud Gateway做路由转发，服务间调用通过Feign实现。支付对接支付宝沙箱环境，图片及文件上传集成MinIO对象存储。提供开箱即用的Docker部署方案：包含MySQL 5.7容器、Nginx反向代理配置（附nginx.conf）、Nacos服务发现容器、各Java微服务镜像构建脚本（Dockerfile）及docker-compose.yml编排文件，支持单机快速启动或云服务器部署。配套交付数据库初始化SQL（按user/club/book/cart/order分库）、系统架构图、核心流程图、Markdown格式项目说明文档、UI参考配置及minio.sh部署辅助脚本。适用于计算机专业课程设计、毕业设计选题或SpringCloud技术实践，代码结构清晰、关键逻辑均有注释，可直接运行验证全流程功能，也便于按需扩展模块或替换技术组件。

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