简介这是一份基于 Spring Boot 和 Vue 构建的开源数字货币交易系统源码面向具备一定 Java 后端基础、希望深入交易所业务场景的全栈开发者。项目实现用户注册登录、实名认证、币币与法币及杠杆交易、钱包充提币、广告管理、订单管理、统计分析和系统权限等完整功能代码分层清晰可帮助读者快速建立对撮合交易、资产账务与后台管理模块的整体认知。资源共 948 个文件其中 Java 源文件 853 个另有 XML 配置、Properties 配置、SQL 脚本、FreeMarker 模板、Nginx 配置文件等覆盖服务端接口、数据库初始化、邮件模板与部署环境压缩包仅 2.16MB整体结构紧凑便于按模块阅读。目前已有 77 人学习下载适合用于课程设计、毕业设计参考或实际平台二次开发尤其适合对照源码梳理充提币流程和各类交易订单状态流转。1. 这套SpringBootVue数字货币交易系统源码解开后比毕设厚实得多这套 SpringBoot Vue 数字货币交易系统源码解开压缩包后并不像毕设那样只有几个 CRUD 页面。bitrade-nginx.conf 和 nginx-admin.conf 两个站点配置说明部署时就把用户端与运营后台拆开了spring.factories 说明后端依赖自动装配机制来组织模块activateEmail.ftl、resetPasswordCodeEmail.ftl 这些 FreeMarker 模板表明注册、改密、实名通知链路都是真实接好的。ZTuo 适合想做交易所原型、研究 Spring Cloud 多模块落地方式、或者要找一套 Vue 管理后台脚手架的开发者三个方向都能从中拿到能直接改的东西。2. ZTuo多模块落地从spring.factories看SpringBoot自动装配2.1 顶层目录对应的工程模块zip 里几个文件的指向性非常明确。bitrade-nginx.conf 是用户端入口nginx-admin.conf 是运营后台入口chat.iml 属于即时通讯模块。把这几个文件映射到源码工程的 Maven 父 POM 里可以看到典型的 Spring Cloud 多服务拆分。模块职责相关技术cloud服务注册与发现Spring Cloud Eurekamember-api注册、登录、实名认证SpringBoot MyBatis Redisexchange-api币币交易与订单SpringBoot MongoDB WebSocketwallet-api充币、提币、地址管理SpringBoot MySQLotc-api法币交易与广告管理SpringBoot FreeMarkeradmin-api运营后台接口SpringBoot Vue 管理端对接chat站内聊天WebSocket后端每个服务都可以独立打包成 jar彼此之间通过注册中心做服务发现网关把请求按路径拆到对应 service。实际部署时消息推送这层需要特别关注我用过直接把 Kafka 接在 exchange 和 market 服务上的方案也见过有人换成 ActiveMQ改动点集中在发送消息的封装类里接口调用方基本不用动。2.2 spring.factories 到底做了什么在 core 或 common 模块的 resources/META-INF 下能看到 spring.factories 文件。Spring Boot 启动时通过 SpringFactoriesLoader 读取这个文件把列出的配置类加载进容器省去在每个业务模块里手动 Import 的重复劳动。文件内容通常是这种结构org.springframework.boot.autoconfigure.EnableAutoConfiguration\ com.ztuo.core.config.MybatisConfig,\ com.ztuo.core.config.RedisConfig,\ com.ztuo.core.config.MongoConfig这段配置的含义是只要 core.jar 出现在某个服务模块的 classpath 下MyBatis、Redis、MongoDB 的初始化逻辑就会被自动加载。写业务代码时不需要知道配置类具体位置排查问题时却能直接定位到这三个类。要注意 Spring Boot 版本差异较新版本已经改用 META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports 文件如果自己升级 SpringBoot 版本需要同步迁移这个声明。2.3 Vue 管理后台与后端 API 的对接方式Vue 端使用 Element UI 这类后台模板负责用户管理、币种配置、实名审核等界面。源码里对 axios 的封装值得直接抄统一处理登录态比每个页面单独写请求头干净得多。常见写法是先创建一个 service 实例再在拦截器里加 tokenconst service axios.create({ baseURL: process.env.VUE_APP_API_BASE || /api, timeout: 15000 }) service.interceptors.request.use(config { const token localStorage.getItem(admin-token) if (token) { config.headers Object.assign({}, config.headers, { Authorization: Bearer token }) } return config }) export default servicebaseURL 用环境变量控制开发环境指向本地 8080生产环境指向网关路径timeout 设成 15000 是为了防止行情接口慢时页面一直转圈。拦截器把 token 放进请求头后端网关统一校验。这里提醒一个 vue-router 的坑路由传参时 query 方式和 params 方式语义不同params 需要路由表里先声明占位符项目中多数跳转用 query 带 id处理后端回跳时不要把两种参数混着读。3. CentOS 6.8上把数据库和SpringBoot服务跑起来的部署顺序3.1 环境依赖与版本匹配项目文档写明操作系统 CentOS 6.8、MySQL 5.5.16。这套组合在今天看起来偏旧但遵循它反而能避开一堆新版本兼容问题。建议准备好以下组件组件参考版本在系统中承担的职责JDK1.8运行所有 SpringBoot jarMySQL5.5.16保存用户、订单、钱包、币种配置Redis3.x缓存登录态、汇率等热点数据MongoDB3.x行情、成交明细、K线数据Nginx1.10托管 Vue 静态资源转发 /api 请求到后端数据库是整个系统的先决条件。主库保存用户与交易数据运营后台的权限数据单独建库行情关系表放在 exchange 库。实际操作中不少表有外键依赖导入顺序不能乱按源码 docs/sql 目录里的编号顺序执行即可。3.2 初始化数据库与字符集陷阱先建库和授权再导入 SQL 脚本CREATE DATABASE IF NOT EXISTS ztuo DEFAULT CHARACTER SET utf8; CREATE USER ztuo% IDENTIFIED BY your-password; GRANT ALL PRIVILEGES ON ztuo.* TO ztuo%; FLUSH PRIVILEGES;mysql -uztuo -p -h 127.0.0.1 ztuo docs/sql/ztuo.sql这里字符集用 utf8 而不是 utf8mb4。MySQL 5.5 对 utf8mb4 的索引长度限制比 5.7 严格交易系统里订单号、提币地址这类字段一旦建了长唯一索引很容易报 Specified key was too long。如果你坚持要用 emoji 做币种名字就得先把字段类型改成 text再让索引只作用于前 N 个字符工程上不推荐。3.3 启动顺序与 Nginx 静态站点启动顺序有讲究先启 cloud 注册中心再启 member、wallet 等业务服务最后起 exchange 和 market因为后两者启动时要向注册中心拉服务列表。推荐用 nohup 后台运行每个 jar 单独写日志nohup java -Xms512m -Xmx1024m -jar cloud.jar logs/cloud.log 21 nohup java -Xms1g -Xmx2g -jar exchange-api.jar logs/exchange.log 21 Xms 和 Xmx 设成一致可以避免 JVM 扩容时停顿堆大小按机器内存调整注册中心 512M 足够业务服务 2G 起步。启动后用 jps 或者 lsof -i:端口 确认进程在监听。Vue 前端打包完成后把 dist 目录内容放到 /data/www/ztuo-web。Nginx 站点配置里最简单的一段是纯静态托管配合 vue-router 的 history 模式server { listen 80; server_name trade.example.com; root /data/www/ztuo-web; index index.html; location / { try_files $uri $uri/ /index.html; } }try_files 的作用是当用户直接刷新 /market/BTC_USDT 这种前端路由时Nginx 找不到对应物理文件就回退到 index.html由 vue-router 接管页面。另一处转发规则在 bitrade-nginx.conf 里把 /api/ 开头的请求转到监听 8100 的网关进程多实例部署时往 upstream 节点列表里追加服务器地址即可。4. 交易核心链路实名认证、钱包与订单撮合的表和代码4.1 用户表与实名认证流程用户体系是交易系统的地基。member 表是最核心的一张表摘取关键字段如下CREATE TABLE member ( id bigint(20) NOT NULL AUTO_INCREMENT, username varchar(64) NOT NULL, password varchar(128) NOT NULL, real_name varchar(64) DEFAULT NULL, google_auth_key varchar(64) DEFAULT NULL, integration bigint(20) DEFAULT 0, create_time datetime DEFAULT NULL, PRIMARY KEY (id), UNIQUE KEY uk_username (username) ) ENGINEInnoDB DEFAULT CHARSETutf8;password 字段用 BCrypt 加密存储长度 128 是为了容纳带盐的哈希串google_auth_key 用于二步验证提币时校验这个 key 能有效防止账号被盗后直接转走资产。实名认证在业务上是一套状态机用户提交证件材料后记录为 APPLY运营后台上通过审核后把 real_name 写入 member 并更新状态拒绝则回写备注。源码里对应的表和接口可以在 member-api 模块里找到admin-api 只负责展示和更新状态两边通过服务层调用而不是直接操作同一张表。4.2 提币申请与二次校验钱包服务里最需要重视的接口是提币。生产环境里常见做法是金额超过阈值时强制走二次校验代码逻辑大致是public void applyWithdraw(WithdrawRecord record, String googleCode) { // 金额超过阈值时强制校验 Google 验证码 if (record.getAmount().compareTo(BigDecimal.valueOf(1000)) 0) { googleAuthService.check(record.getUserId(), googleCode); } // 地址白名单检查避免转错地址 walletAddressService.checkAddress(record.getUserId(), record.getAddress()); record.setStatus(WithdrawStatus.APPLYING); withdrawMapper.insert(record); messageSender.pushWithdrawNotice(record.getUserId(), record); }first check threshold: BigDecimal compareTo 避免了 double 比较的精度问题地址白名单是另一层护栏用户第一次使用新地址时强制增加冷却时间这个列表在 wallet-api 对应的数据库表里维护。源码里 withdraw 相关表包含 member_id 外键和 status 字段状态流转是 APPLYING → APPROVED → SUCCESS整个流程的每个路由节点都要留操作日志否则财务对账时没法回溯。4.3 订单撮合的边界条件币币交易的核心是订单簿匹配这里最容易错的是价格比较方向。简化后的撮合循环如下public void matchOrder(Order taker) { while (taker.getRemaining().compareTo(BigDecimal.ZERO) 0) { Order maker orderBook.peekBest(taker.getSide().opposite()); if (maker null) break; if (taker.getSide() Side.BUY maker.getPrice().compareTo(taker.getPrice()) 0) { break; } if (taker.getSide() Side.SELL maker.getPrice().compareTo(taker.getPrice()) 0) { break; } BigDecimal fillPrice maker.getPrice(); BigDecimal fillAmount taker.getRemaining().min(maker.getRemaining()); createTrade(taker, maker, fillPrice, fillAmount); taker.setRemaining(taker.getRemaining().subtract(fillAmount)); maker.setRemaining(maker.getRemaining().subtract(fillAmount)); if (maker.getRemaining().signum() 0) { orderBook.popBest(taker.getSide().opposite()); } } }peekBest 只读取不删除对手单成交完成后才能移除否则异常中断会导致订单丢失价格比较必须区分买卖方向买入单只看对手卖价是否小于等于自己限价卖出单反过来数量全部用 BigDecimal浮点数在这个场景不能出现。撮合结束后要写交易明细到 MongoDB再通过 WebSocket 推送成交和 K 线。这个模块最容易出的问题是同一个 taker 订单重复进入撮合必须在入口处根据订单状态做幂等判断否则用户会看到资产被重复扣减。5. FreeMarker邮件模板与Vue打包路径上线前最后要抠的细节5.1 模板变量要和接口返回严格对应zip 里的几个 .ftl 都是 FreeMarker 模板。activateEmail.ftl 的结构和参数要跟 member-api 里发送邮件的方法对齐模板里写错一个变量名用户收到的就是一封空白邮件p尊敬的 ${username}/p p请点击下面的链接完成邮箱验证/p a href${activateUrl}${activateUrl}/a p链接 15 分钟内有效如果非本人操作请忽略本邮件。/pMapString, Object model new HashMap(); model.put(username, member.getUsername()); model.put(activateUrl, buildUrl(member.getActivateToken())); emailService.sendTemplateMail(member.getEmail(), 激活账户, activateEmail.ftl, model);真实项目里踩过这样的坑后端返回字段叫 activateUrl模板里写成 activationUrl本地测试邮箱客户端容错没看出来线上用户反馈点不了链接。排查时先用模板渲染测试类单独跑一次确认所有占位符都被填充。5.2 Vue打包后布局异常多半是publicPath问题很多人在这个项目上遇到 vue 打包后布局异常CSS 和 JS 都加载了但页面错乱打开 Network 面板会发现静态资源 404。这是因为部署路径和 publicPath 不匹配。Vue CLI 工程里这样解决module.exports { publicPath: process.env.VUE_APP_PUBLIC_PATH || /, assetsDir: static, productionSourceMap: false, devServer: { port: 8080, host: 0.0.0.0 } }用户端部署在域名根路径时 publicPath 用 /运营后台要部署到 /admin/ 这种子目录时构建前设置 VUE_APP_PUBLIC_PATH/admin/否则 CSS 里的背景图和路由懒加载 chunk 全会按根路径去找资源页面自然乱掉。改完重新 npm run build再检查 dist/index.html 里引用路径是否带上了子目录前缀。5.3 一条命令验证整条链路部署完成后先别急着点页面用 curl 验证网关到会员服务的链路curl -I http://127.0.0.1/api/platform/info tail -f logs/member-api.log | grep ERROR返回 200 说明网关到 member 服务的转发规则生效404 优先检查 nginx 转发规则和 location 前缀500 去 tail 日志看具体异常栈。curl 返回 200、日志没有新增 ERROR再去做实名认证和充提币流程的联调。本文还有配套的精品资源点击获取