超简单！PIG微服务框架开发环境搭建指南
项目地址: https://gitcode.com/pig-mesh/pig 还在为复杂的微服务开发环境配置头疼吗？PIG基于Spring Cloud 2025的最新架构，5分钟即可完成开发环境搭建！本文将手把手教你配置PIG微服务框架的开发环境。
读完本文你将获得：
- ✅ Java 17开发环境配置
- ✅ Maven依赖管理技巧
- ✅ Docker容器化部署方案
- ✅ 多模块项目启动方法
环境要求与前置准备
硬件要求
- 内存：≥8GB（推荐16GB）
- 磁盘空间：≥10GB可用空间
- CPU：4核以上处理器
软件要求
| 软件名称 | 版本要求 | 下载地址 |
|---|---|---|
| JDK | 17+ | Oracle JDK |
| Maven | 3.6.3+ | Apache Maven |
| Docker | 20.10+ | Docker Desktop |
| Git | 2.30+ | Git SCM |
项目克隆与初始化
# 克隆项目代码
git clone https://gitcode.com/pig-mesh/pig
cd pig
# 检查项目结构
tree -L 2
项目采用多模块设计，包含注册中心、网关、认证服务等核心模块。
Java开发环境配置
JDK 17安装验证
# 检查Java版本
java -version
# 应该输出：java version "17.x.x"
# 设置JAVA_HOME环境变量
export JAVA_HOME=/path/to/jdk17
export PATH=$JAVA_HOME/bin:$PATH
Maven配置优化
编辑 ~/.m2/settings.xml 文件，配置镜像加速：
<mirrors>
<mirror>
<id>aliyunmaven</id>
<mirrorOf>*</mirrorOf>
<name>阿里云公共仓库</name>
<url>https://maven.aliyun.com/repository/public</url>
</mirror>
</mirrors>
Docker环境部署
一键启动所有服务
# 使用Docker Compose启动全部服务
docker-compose up -d
# 查看服务状态
docker-compose ps
Docker Compose编排了MySQL、Redis、Nacos等基础设施服务。
服务端口映射
| 服务名称 | 端口 | 访问地址 |
|---|---|---|
| MySQL | 33306 | localhost:33306 |
| Redis | 36379 | localhost:36379 |
| Nacos | 8848 | localhost:8848 |
| Gateway | 9999 | localhost:9999 |
开发模式启动
单体模式启动（推荐开发使用）
# 进入单体启动模块
cd pig-boot
# 编译并启动
mvn clean spring-boot:run
微服务模式启动
# 按顺序启动各个微服务
cd pig-register && mvn spring-boot:run # Nacos注册中心
cd pig-auth && mvn spring-boot:run # 认证服务
cd pig-gateway && mvn spring-boot:run # API网关
cd pig-upms && mvn spring-boot:run # 用户权限管理
常见问题排查
依赖下载失败
# 清理本地仓库并重新下载
mvn clean install -U
端口冲突解决
修改各服务的配置文件中的端口号，或停止占用端口的其他进程。
内存不足处理
增加Docker内存分配至6GB以上，或单独启动资源消耗较大的服务。
开发技巧与最佳实践
- 代码格式化：项目使用Spring Java Format规范，安装对应IDE插件
- 配置管理：通过Nacos进行统一配置管理 pig-register/
- 日志查看：使用pig-common-log模块进行分布式日志收集
- 数据库操作：通过pig-upms的API进行用户权限管理
下一步学习建议
完成环境搭建后，建议：
- 访问localhost:9999查看网关是否正常
- 登录Nacos控制台localhost:8848查看服务注册情况
- 阅读官方文档深入了解各模块功能
- 尝试修改配置并观察服务变化
开发环境配置完成！现在你可以开始PIG微服务项目的开发之旅了。记得点赞收藏，随时回看这份指南～
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
