1. PigX框架部署安装指南

作为一名长期从事微服务开发的工程师，我最近开始研究PigX这个号称"开箱即用"的微服务开发平台。第一天接触这个框架，最基础也最重要的就是先把环境搭建起来。下面我会详细记录PigX的完整部署过程，包括你可能遇到的各种坑和解决方案。

PigX是一个基于Spring Cloud的微服务开发平台，它整合了当前主流的技术栈，提供了从开发到部署的全套解决方案。对于想要快速构建微服务系统的团队来说，PigX确实能节省不少前期搭建基础设施的时间。不过，它的部署过程并不像官方文档描述的那么简单，特别是在不同环境下的适配问题需要特别注意。

1.1 环境准备

在开始安装前，我们需要准备好基础环境。PigX官方推荐使用以下配置：

• JDK 1.8+（实测OpenJDK 11也能正常运行）
• MySQL 5.7+（建议8.0版本）
• Redis 3.2+
• Maven 3.5+
• Nacos 1.4.1+（用于服务发现和配置中心）

注意：如果你的机器上已经安装了Docker，可以考虑使用Docker-compose来快速启动这些依赖服务，这能避免很多环境冲突问题。

我个人的开发环境是Ubuntu 20.04，但下面的步骤在CentOS和MacOS上同样适用。Windows用户需要注意路径和权限问题。

1.2 源码获取与编译

PigX的源代码托管在Gitee上，我们可以直接克隆官方仓库：

git clone https://gitee.com/pigx/pigx.git cd pigx

项目采用Maven进行构建，但由于包含多个模块，首次编译可能会比较耗时：

mvn clean install -DskipTests

这里有几个常见问题需要注意：

1. 网络问题可能导致依赖下载失败，建议配置国内镜像源
2. JDK版本不兼容会报错，确保使用1.8或11
3. 内存不足可能导致编译失败，可以增加Maven内存参数

编译成功后，你会在各模块的target目录下看到生成的jar包。

2. 数据库初始化

PigX需要两个主要的数据库：业务数据库和Nacos配置数据库。我们先来处理MySQL部分。

2.1 创建数据库

登录MySQL后执行以下命令：

CREATE DATABASE `pig` DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; CREATE DATABASE `pig_config` DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;

然后导入初始数据。PigX提供了SQL脚本，位于：

pigx-admin/src/main/resources/sql/pig.sql pigx-auth/src/main/resources/sql/pig_config.sql

你可以直接用MySQL客户端导入这些文件：

mysql -uroot -p pig < pigx-admin/src/main/resources/sql/pig.sql mysql -uroot -p pig_config < pigx-auth/src/main/resources/sql/pig_config.sql

2.2 数据库连接配置

修改pigx-admin和pigx-auth模块中的application.yml文件，更新数据库连接信息：

spring: datasource: url: jdbc:mysql://localhost:3306/pig?useUnicode=true&characterEncoding=utf-8&useSSL=false username: root password: yourpassword

重要提示：生产环境务必不要使用root账户，应该创建专用用户并限制权限。

3. 服务启动与配置

3.1 Nacos服务启动

PigX使用Nacos作为配置中心和服务发现。我们可以使用Docker快速启动Nacos：

docker run --name nacos -e MODE=standalone -p 8848:8848 -d nacos/nacos-server:1.4.1

启动后访问http://localhost:8848/nacos，默认账号密码都是nacos。

在Nacos控制台中，我们需要导入PigX的配置。配置文件的路径在：

pigx-common/pigx-common-core/src/main/resources/nacos/pigx-nacos.yml

3.2 启动PigX服务

现在可以按顺序启动各个服务了：

1. 首先启动注册中心：

cd pigx-register mvn spring-boot:run

2. 然后启动授权服务：

cd pigx-auth mvn spring-boot:run

3. 最后启动后台管理服务：

cd pigx-admin mvn spring-boot:run

服务启动后，你可以通过以下URL访问：

• 注册中心：http://localhost:8848/nacos
• 管理后台：http://localhost:8080
• Swagger API文档：http://localhost:8080/doc.html

4. 常见问题与解决方案

在实际部署过程中，我遇到了几个典型问题，这里分享解决方案：

4.1 端口冲突问题

PigX默认使用以下端口：

• 注册中心：8848
• 授权服务：3000
• 管理后台：8080

如果这些端口被占用，可以在各自的application.yml中修改server.port配置。

4.2 依赖缺失问题

有时候Maven可能无法正确下载所有依赖。解决方法有：

1. 删除本地仓库中相关依赖重新下载
2. 检查Maven的settings.xml配置了正确的镜像源
3. 尝试使用IDE（如IDEA）的Maven工具进行依赖刷新

4.3 数据库连接失败

如果服务启动时报数据库连接错误，检查：

1. MySQL服务是否正常运行
2. 数据库用户是否有足够权限
3. 连接URL中的参数是否正确（特别是SSL和时区设置）

4.4 前端访问问题

管理后台启动后，如果前端无法访问，可能是：

1. 跨域问题：检查Nginx或网关配置
2. 静态资源未加载：清理浏览器缓存
3. 接口404：确保后端服务已正常启动

5. 生产环境部署建议

虽然我们成功在本地运行了PigX，但生产环境部署还需要考虑更多因素：

5.1 集群化部署

对于关键服务如注册中心和网关，应该部署集群以提高可用性。Nacos支持集群模式，只需要修改cluster.conf文件配置节点信息。

5.2 配置分离

生产环境应该将敏感配置（如数据库密码）从代码中分离，可以通过：

1. Nacos配置中心管理
2. 外部化配置文件
3. 环境变量注入

5.3 监控与日志

建议集成以下组件：

1. Spring Boot Admin用于服务监控
2. ELK或Loki+Granfa用于日志收集
3. Prometheus+Granfa用于指标监控

5.4 安全加固

生产环境必须进行安全加固：

1. 修改所有默认密码（Nacos、MySQL等）
2. 启用HTTPS
3. 配置适当的防火墙规则
4. 定期更新依赖库版本

我在实际部署中发现，PigX虽然功能强大，但文档相对简略，很多配置需要自己摸索。特别是权限系统和网关配置，需要仔细研究源码才能理解其工作原理。建议在正式使用前，先充分测试各个功能模块，确保它们符合你的业务需求。