从零到一：手把手教你用SpringBoot+MyBatis搭建苍穹外卖后端（含Git版本控制与Nginx配置）

从零到一：手把手教你用SpringBoot+MyBatis搭建苍穹外卖后端（含Git版本控制与Nginx配置）

在当今快节奏的餐饮行业数字化转型浪潮中，一套高效稳定的外卖系统后端架构已成为餐饮企业的核心竞争力。本文将带你从零开始，使用SpringBoot和MyBatis构建一个完整的苍穹外卖后端系统，涵盖多模块工程划分、Git版本控制、Nginx配置等实战环节。无论你是刚接触Java后端开发的初学者，还是希望提升工程化实践能力的开发者，这篇指南都将为你提供清晰的实现路径。

1. 项目初始化与多模块架构设计

现代Java项目往往采用多模块架构来提升代码的可维护性和复用性。对于苍穹外卖这样的商业级项目，合理的模块划分能够有效隔离业务边界，降低代码耦合度。

1.1 创建Maven父工程

首先使用Spring Initializr创建一个标准的SpringBoot项目作为父工程：

mvn archetype:generate -DgroupId=com.sky -DartifactId=sky-take-out -DarchetypeArtifactId=maven-archetype-quickstart -DinteractiveMode=false

在pom.xml中定义模块继承关系和统一依赖管理：

<modules> <module>sky-common</module> <module>sky-pojo</module> <module>sky-server</module> </modules> <dependencyManagement> <dependencies> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-dependencies</artifactId> <version>2.7.0</version> <type>pom</type> <scope>import</scope> </dependency> </dependencies> </dependencyManagement>

1.2 核心模块功能划分

sky-common模块建议包含以下包结构：

├── constant # 系统常量定义 ├── context # 线程上下文管理 ├── exception # 自定义异常体系 ├── utils # 通用工具类集合 └── result # 统一响应格式封装

2. MyBatis集成与数据层开发

MyBatis作为轻量级ORM框架，在复杂SQL场景下展现出明显优势。以下是整合过程中的关键步骤：

2.1 数据源与MyBatis配置

在application.yml中配置数据源和MyBatis参数：

spring: datasource: url: jdbc:mysql://localhost:3306/sky_take_out?useSSL=false username: root password: 123456 driver-class-name: com.mysql.cj.jdbc.Driver mybatis: mapper-locations: classpath:mapper/*.xml configuration: map-underscore-to-camel-case: true

2.2 动态SQL编写技巧

在Mapper XML中使用MyBatis动态SQL实现灵活查询：

<select id="queryDishes" resultType="DishVO"> SELECT * FROM dish <where> <if test="categoryId != null"> AND category_id = #{categoryId} </if> <if test="name != null and name != ''"> AND name LIKE CONCAT('%',#{name},'%') </if> <if test="status != null"> AND status = #{status} </if> </where> ORDER BY update_time DESC </select>

提示：使用@MapperScan注解批量扫描Mapper接口，避免每个接口都添加@Mapper注解

3. Git版本控制实战

规范的版本控制是团队协作的基础。以下是Git工作流的具体实施建议：

3.1 初始化本地仓库

# 初始化本地仓库 git init # 创建.gitignore文件 echo "/target/ /.idea/ *.iml" > .gitignore # 提交初始代码 git add . git commit -m "init: 项目初始化"

3.2 分支管理策略

• master：生产环境对应分支，仅接受经过测试的合并请求
• develop：集成开发分支，功能开发完成后的合并目标
• feature/：功能开发分支，按功能模块创建
• hotfix/：紧急修复分支，用于生产环境问题快速修复

# 创建并切换到新功能分支 git checkout -b feature/user-management # 开发完成后合并到develop分支 git checkout develop git merge --no-ff feature/user-management

4. Nginx高级配置技巧

Nginx作为反向代理服务器，能显著提升系统性能和安全性。

4.1 反向代理配置

server { listen 80; server_name api.sky.com; location /api/ { proxy_pass http://localhost:8080/; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; # 静态资源缓存设置 location ~* \.(jpg|png|css|js)$ { expires 7d; add_header Cache-Control "public"; } } }

4.2 负载均衡策略对比

upstream backend { server 192.168.1.101:8080 weight=3; server 192.168.1.102:8080; server 192.168.1.103:8080 backup; keepalive 32; # 保持长连接数量 }

5. 接口文档与Swagger集成

良好的API文档能极大提升前后端协作效率。Knife4j作为Swagger的增强工具，提供了更友好的文档界面。

5.1 Knife4j配置类示例

@Configuration @EnableSwagger2 public class SwaggerConfig { @Bean public Docket createRestApi() { return new Docket(DocumentationType.SWAGGER_2) .apiInfo(apiInfo()) .select() .apis(RequestHandlerSelectors.basePackage("com.sky.controller")) .paths(PathSelectors.any()) .build() .securitySchemes(securitySchemes()); } private List<ApiKey> securitySchemes() { return Arrays.asList( new ApiKey("Authorization", "Authorization", "header")); } private ApiInfo apiInfo() { return new ApiInfoBuilder() .title("苍穹外卖API文档") .description("接口说明") .version("1.0") .build(); } }

5.2 接口注释规范示例

@Api(tags = "菜品管理") @RestController @RequestMapping("/dish") public class DishController { @ApiOperation("新增菜品") @PostMapping public Result<Long> save(@RequestBody DishDTO dishDTO) { // 方法实现... } @ApiOperation(value = "菜品分页查询", notes = "可根据分类、名称筛选") @GetMapping("/page") public Result<PageResult> page(DishPageQueryDTO queryDTO) { // 方法实现... } }

在实际项目中，我们通常会遇到各种边界情况。比如在实现购物车功能时，需要特别注意并发场景下的数据一致性问题。通过Redis分布式锁可以有效解决这类问题，但也要权衡性能与一致性的平衡。