本地开发说明

本文档适合有一定基础的人看，需要具备SpringCloud/SringBoot开发基础、Vue/Npm前端开发基础、Mysql基础、Mongodb基础、Redis基础、Linux基础。一般而言，大部分Java程序员都具备这些能力。

同时，如果需要连接区块链，对区块链钱包进行操作/数据获取，你还需要具备一些区块链相关的基础知识，包括但不限于：搭建比特币/以太坊等节点、区块链节点RPC访问、比特币钱包基础、以太坊钱包基础等。一般而言，你不需要特别精通区块链的运行过程，只需要对区块链的运行原理有一定的了解。

本项目前后端分离，如果你是一个全栈程序员，这个项目应该很快就能调试通。 有什么问题可以添加QQ：877070886，我会给予一定的技术援助（小白问题请绕过）。

关于Framework开发

00_Framework文件夹下的项目是所有服务的集合，通过SpringCloud的微服务开发模式进行开发，你可以通过Eclipse打开整个工程项目，我的开发工具版本如下：

Eclipse Java EE IDE for Web Developers.

Version: Photon Release (4.8.0)

Build id: 20180619-1200

首先，为开发工具安装Lombok插件。

用Eclipse打开项目后，你的开发工程目录应该如下图所示：

编译项目时，请先编译core以及xxx-core项目，否则会提示缺少类（本项目使用JPA QueryDsl实现表操作）。

每个项目都有独立的服务端口（配置文件中），你可以直接通过（IP：端口）调用服务，也可以通过网关（Cloud项目，7000端口）调用服务，也可以通过配置Nginx反向代理进行服务调用（生产环境使用此种方式）

关于后台管理Web端开发

配置文件在src/config/api.js，你可以在这里配置你的Admin服务IP端口，因为后台管理web只会调用一个Admin服务，所以，你可以选择直接指定到Admin服务IP：端口。

同时，你还需要修改src/service/http.js文件中的访问配置。

启动方式：通过npm run dev即可热启动项目，通过npm run build可编译出部署文件。

关于前台Web端开发

前台Web端（PC）因为要访问不同的服务，像个人信息需要调用Ucenter提供的服务，交易需要调用Exchange-api的服务，所以，你需要通过网关的方式为前端提供服务。 配置文件在：src/main.js，你可通过修改Vue.prototype.rootHost及Vue.prototype.host来实现对后端服务的调用。

关于数据库（MySQL）

数据库文件在00_Framework/sql文件夹下，提供了db_patch，这个文件仅提供了一些基础数据（菜单树、管理员权限等），其他的数据库表会在jar包首次运行的时候自动更新到数据库，配置项在：

#jpa

spring.jpa.show-sql=true

spring.data.jpa.repositories.enabled=true

spring.jpa.hibernate.ddl-auto=update

如果你不希望数据库表与Java类实体动态更新，你可选择修改配置项：spring.jpa.hibernate.ddl-auto=update

环境配置

系统运行依赖于Mongodb、Redis、MySQL、kafka、阿里云OSS，所以你需要准备好这些基础服务。

常见编译问题（Error）

一、启动ucenter-api时，提示下列错误： Error creating bean with name 'enableRedisKeyspaceNotificationsInitializer' defined in class path resource 原因：使用了注解：@EnableRedisHttpSession，这个注解是用来开启Redis来集式式管理Session。而在使用这种方式的时候，是需要Redis开启Keyspace Notifications功能的，默认是关闭的。这个功能有一个参数来控制它，notify-keyspace-events，把它的值改为Egx。 腾讯云中的redis参数notify-keyspace-events修改方法：进入实例->参数，修改即可。

2、运行jar包提示Failed to get nested archive for entry BOOT....... 提示缺少spark.xxxx.DB类，这是因为编译时未将spark-core.jar拷贝到压缩包中，这个时候需要将pom.xml文件中修改一下，追加： true 追加位置：spring-boot-maven-plugin，与平级 然后删除target下的jar包，重新生成，最好run maven clean以后再maven install

3、org.apache.shiro.authz.UnauthorizedException: Subject does not have permission [system:announcement:deletes] 这种错误是操作没有权限导致，检查操作的方法与数据库中的是否一致。 第一步，通过浏览器F12查看请求的链接，一般显示404 第二步，检查数据库中admin_permission表中是否有要访问的链接

3、market.jar启动失败，提示connection refuesed之类的错误，首先用netstat -tunlp查看端口6005（也就是exchange）是否有监听，如果没有，则说明exchange未完全启动。 导致exchange启动慢的原因主要是初始化时，对未完成的订单加载慢。初始化时，需要从mangodb加载订单成交详情，这是非常巨大的数据。

一些配置项说明

1、market/application.properties # 二级推荐人币币手续费佣金是否发放(true：开放 false：不开放) second.referrer.award=false

2、ucenter-api/application.properties # system(发送邮件使用) spark.system.work-id=1 spark.system.data-center-id=1 spark.system.host= spark.system.name= * #推荐注册奖励，1=被推荐人必须实名认证才可获得奖励，否则无限制，要与admin模块里面的配置保持统一 commission.need.real-name=1 #推荐注册奖励是否开启二级奖励（1=开启，0=关闭） commission.promotion.second-level=0 #个人推广链接的前缀，随着登录接口返回给客户端。客户端那边与推广码连接，组成个人推广链接。如果有推广注册功能必填 person.promote.prefix=http://www.bizzan.com/#/register?agent= #转账接口地址 transfer.url= transfer.key= transfer.smac=

Nginx配置

参考网址：

https://blog.csdn.net/qq_36628908/article/details/80243713

nginx文档目录：usr/local/nginx/html/、usr/local/nginx/conf/

注意事项：

1. api.xxxx.com 与 www.xxxx.com需要转发不同服务

2. 需要api.xxxx.com支持websocket

===========================

依赖环境

yum install -y wget  
yum install -y vim-enhanced  
yum install -y make cmake gcc gcc-c++  
yum install -y pcre pcre-devel
yum install -y zlib zlib-devel
yum install -y openssl openssl-devel

下载nginx-1.12.2.tar.gz wget http://nginx.org/download/nginx-1.12.2.tar.gz

编译安装

tar -zxvf nginx-1.12.2.tar.gz 
cd nginx-1.12.2

./configure \
--prefix=/usr/local/nginx \
--pid-path=/var/run/nginx/nginx.pid \
--lock-path=/var/lock/nginx.lock \
--error-log-path=/var/log/nginx/error.log \
--http-log-path=/var/log/nginx/access.log \
--with-http_gzip_static_module \
--http-client-body-temp-path=/var/temp/nginx/client \
--http-proxy-temp-path=/var/temp/nginx/proxy \
--http-fastcgi-temp-path=/var/temp/nginx/fastcgi \
--http-uwsgi-temp-path=/var/temp/nginx/uwsgi \
--with-http_stub_status_module \
--with-http_ssl_module \
--http-scgi-temp-path=/var/temp/nginx/scgi \
--with-stream --with-stream_ssl_module

make 
make install

关于访问服务

你可以通过Eruka的服务调度中心看到每个服务（http://localhost:7000），或者通过zuul统一网关调用服务，为了方便，我本地开发的方式是用nginx反向代理各种服务，配置参考如下：

    server_name locahost;
    location /market {
        client_max_body_size    5m;
        proxy_pass http://localhost:6004;
        proxy_set_header Host $http_host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Scheme $scheme;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
    }
    location /exchange {
        client_max_body_size    5m;
        proxy_pass http://localhost:6003;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
    location /uc {
        client_max_body_size    5m;
        proxy_pass http://localhost:6001;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
    location /admin {
        client_max_body_size    5m;
        proxy_pass http://localhost:6010;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
    location /chat {
        client_max_body_size    5m;
        proxy_pass http://localhost:6008;
        proxy_set_header Host $host;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        proxy_set_header X-Real-IP $remote_addr;
    }