基于Spring Boot的宠物社交小程序开发实践

1. 项目概述与背景

"爪友"宠物社交小程序是我在完成计算机专业毕业设计时开发的一个综合性项目。作为一名资深宠物爱好者，我注意到身边许多养宠朋友都面临着社交圈狭窄、养宠知识获取困难、宠物服务信息不对称等问题。根据《2022年中国宠物行业白皮书》显示，国内城镇宠物主数量已突破7000万，但专门针对宠物主的垂直社交平台却寥寥无几。

这个项目采用Java技术栈开发，前端使用微信小程序，后端基于Spring Boot框架，数据库选用MySQL 8.0。系统实现了宠物档案管理、社交互动、商城购物、领养服务等核心功能模块，旨在为宠物主打造一个集记录、分享、服务于一体的综合性平台。

提示：项目开发环境建议使用IntelliJ IDEA + MySQL 8.0 + JDK 1.8组合，这是目前Java生态中最稳定高效的开发环境配置。

2. 系统架构设计

2.1 技术选型分析

后端框架选择Spring Boot 2.7.x版本，主要基于以下考虑：

1. 自动配置特性大幅减少XML配置
2. 内嵌Tomcat服务器简化部署流程
3. 丰富的Starter依赖可快速集成常用组件
4. 完善的文档和社区支持

数据库选用MySQL 8.0而非5.7版本，主要因为：

• 8.0版本对JSON数据类型支持更好
• 性能提升显著，特别是读写并发能力
• 新增的窗口函数等特性便于复杂查询

前端采用微信小程序而非原生App，优势在于：

• 开发成本低，无需考虑多端适配
• 用户无需下载安装，使用门槛低
• 依托微信生态，传播和获客更容易

2.2 系统分层架构

系统采用经典的三层架构设计：

code复制表现层(Web)
  ↓
业务逻辑层(Service)
  ↓
数据访问层(DAO)
  ↓
数据库(MySQL)

关键类设计示例：

• Controller层：PetInfoController、OrderController
• Service层：PetInfoServiceImpl、OrderServiceImpl
• DAO层：PetInfoMapper、OrderMapper

3. 核心功能实现

3.1 宠物档案管理模块

3.1.1 数据库表设计

sql复制CREATE TABLE `pet_info` (
  `id` bigint NOT NULL AUTO_INCREMENT,
  `user_id` bigint NOT NULL COMMENT '所属用户ID',
  `pet_name` varchar(50) NOT NULL COMMENT '宠物名称',
  `pet_type` varchar(20) NOT NULL COMMENT '宠物类型',
  `birthday` date DEFAULT NULL COMMENT '出生日期',
  `gender` tinyint DEFAULT '0' COMMENT '性别：0未知 1公 2母',
  `weight` decimal(5,2) DEFAULT NULL COMMENT '体重(kg)',
  `avatar` varchar(255) DEFAULT NULL COMMENT '头像URL',
  `health_status` varchar(20) DEFAULT '健康' COMMENT '健康状况',
  `create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP,
  PRIMARY KEY (`id`),
  KEY `idx_user_id` (`user_id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

3.1.2 关键业务逻辑

宠物信息添加流程：

1. 前端收集表单数据（含图片上传）
2. 调用后端API /api/pet/add
3. 服务层验证数据合法性
4. 处理图片上传至OSS
5. 持久化数据到数据库
6. 返回操作结果

注意：图片上传需限制文件大小（建议<2MB）和类型（jpg/png），防止恶意上传。

3.2 社区互动模块

3.2.1 动态发布实现

核心代码片段：

java复制@PostMapping("/post/create")
public Result createPost(@RequestBody PostDTO postDTO) {
    // 1. 参数校验
    if (StringUtils.isBlank(postDTO.getContent())) {
        return Result.fail("内容不能为空");
    }
    
    // 2. 构建实体
    Post post = new Post();
    BeanUtils.copyProperties(postDTO, post);
    post.setUserId(SecurityUtils.getCurrentUserId());
    
    // 3. 处理图片
    if (CollectionUtils.isNotEmpty(postDTO.getImages())) {
        List<String> imageUrls = ossService.uploadBatch(postDTO.getImages());
        post.setImages(JSON.toJSONString(imageUrls));
    }
    
    // 4. 保存到数据库
    postMapper.insert(post);
    
    // 5. 异步处理（如通知粉丝）
    eventPublisher.publishEvent(new PostEvent(post));
    
    return Result.success(post.getId());
}

3.2.2 性能优化措施

1. 分页查询优化：

sql复制SELECT * FROM post 
WHERE user_id = #{userId} 
ORDER BY create_time DESC 
LIMIT #{offset}, #{pageSize}

2. 使用Redis缓存热门帖子：

java复制// 获取周榜热帖
public List<Post> getWeeklyHotPosts() {
    String cacheKey = "post:weekly_hot";
    List<Post> cached = redisTemplate.opsForValue().get(cacheKey);
    if (cached != null) {
        return cached;
    }
    
    List<Post> posts = postMapper.selectWeeklyHot();
    redisTemplate.opsForValue().set(cacheKey, posts, 1, TimeUnit.HOURS);
    return posts;
}

4. 宠物商城实现

4.1 购物车设计

数据库表结构：

sql复制CREATE TABLE `cart_item` (
  `id` bigint NOT NULL AUTO_INCREMENT,
  `user_id` bigint NOT NULL,
  `product_id` bigint NOT NULL,
  `quantity` int NOT NULL DEFAULT '1',
  `selected` tinyint NOT NULL DEFAULT '1' COMMENT '是否选中',
  `create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP,
  PRIMARY KEY (`id`),
  UNIQUE KEY `uk_user_product` (`user_id`,`product_id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

4.2 订单状态机

使用状态模式实现订单流程：

java复制public interface OrderState {
    void pay(Order order);
    void deliver(Order order);
    void receive(Order order);
    void cancel(Order order);
}

// 具体状态实现
public class UnpaidState implements OrderState {
    @Override
    public void pay(Order order) {
        order.setState(new PaidState());
        // 更新数据库...
    }
    
    @Override
    public void cancel(Order order) {
        order.setState(new CancelledState());
        // 释放库存...
    }
}

5. 领养服务模块

5.1 领养流程设计

1. 送养人发布信息
2. 管理员审核
3. 意向用户提交申请
4. 双方沟通确认
5. 线下完成领养
6. 系统记录领养结果

5.2 关键数据库表

sql复制CREATE TABLE `adoption_info` (
  `id` bigint NOT NULL AUTO_INCREMENT,
  `pet_name` varchar(50) NOT NULL,
  `pet_type` varchar(20) NOT NULL,
  `age` int DEFAULT NULL COMMENT '月龄',
  `gender` tinyint DEFAULT NULL,
  `health_status` varchar(20) DEFAULT NULL,
  `description` varchar(500) DEFAULT NULL,
  `address` varchar(100) NOT NULL,
  `contact_way` varchar(50) NOT NULL,
  `status` tinyint NOT NULL DEFAULT '0' COMMENT '0-待审核 1-已发布 2-已领养',
  `creator_id` bigint NOT NULL,
  `create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP,
  PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

6. 部署与运维

6.1 服务器配置建议

最低配置要求：

• CPU：2核
• 内存：4GB
• 磁盘：50GB
• 带宽：5Mbps

推荐使用Docker Compose部署：

yaml复制version: '3'
services:
  mysql:
    image: mysql:8.0
    environment:
      MYSQL_ROOT_PASSWORD: yourpassword
    volumes:
      - ./mysql-data:/var/lib/mysql
    ports:
      - "3306:3306"
      
  redis:
    image: redis:6
    ports:
      - "6379:6379"
      
  app:
    build: .
    ports:
      - "8080:8080"
    depends_on:
      - mysql
      - redis

6.2 常见问题排查

1. 微信登录失败：

• 检查小程序appid和secret配置
• 确认域名已加入微信公众平台白名单
• 验证签名算法是否正确

2. 图片上传失败：

• 检查OSS配置信息
• 确认存储空间权限设置
• 验证文件大小是否符合限制

3. 数据库连接超时：

• 检查MySQL服务状态
• 验证连接池配置
• 排查网络连通性

7. 项目总结与改进方向

在实际开发过程中，有几个关键点值得特别注意：

1. 微信支付集成：需要仔细阅读官方文档，特别注意签名生成和验签流程。建议使用官方SDK而非自行实现。

2. 敏感数据处理：用户手机号等隐私信息应当加密存储，推荐使用AES等对称加密算法。

3. 性能监控：生产环境建议集成Prometheus + Grafana监控系统关键指标。

后续改进方向：

• 增加宠物健康管理功能（疫苗提醒、体检记录等）
• 引入推荐算法优化内容分发
• 开发多端适配（H5、App）
• 接入智能客服系统

这个项目从需求分析到最终上线历时4个月，让我对全栈开发有了更深入的理解。最大的收获是学会了如何在技术选型时权衡各种因素，以及如何处理实际开发中遇到的各种边界情况。