Spring Boot 3与微信小程序构建网文阅读系统实践

1. 项目概述

作为一名有多年开发经验的Java工程师，最近我完成了一个基于Spring Boot 3的网文阅读系统开发。这个项目采用前后端分离架构，后端使用Spring Boot 3 + MyBatis Plus，前端使用微信小程序，数据库选用MySQL 8.0。系统主要实现了小说展示、购买阅读、书架管理等功能模块。

在开发过程中，我发现Spring Boot 3的新特性如GraalVM原生镜像支持、JDK 17的Record类等都能很好地提升系统性能。同时，微信小程序的轻量级特性也让用户能够随时随地享受阅读乐趣。

2. 技术选型与架构设计

2.1 技术栈解析

后端技术栈：

• Spring Boot 3.1.5：提供快速开发能力
• MyBatis Plus 3.5.3：简化数据库操作
• Redis 7.0：缓存热点数据
• JWT：实现无状态认证
• Swagger 3.0：API文档生成

前端技术栈：

• 微信小程序原生开发
• Vant Weapp组件库
• ECharts for Weixin：数据可视化

数据库：

• MySQL 8.0：主数据库
• Redis 7.0：缓存数据库

2.2 系统架构设计

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

code复制客户端层(微信小程序)
   ↓
API网关层(Spring Cloud Gateway)
   ↓
业务逻辑层(Spring Boot微服务)
   ↓
数据访问层(MyBatis Plus + Redis)
   ↓
数据存储层(MySQL)

这种分层架构的优势在于：

1. 职责分离，各层专注自己的功能
2. 易于扩展和维护
3. 可以针对不同层进行独立优化
4. 便于团队协作开发

3. 核心功能实现

3.1 用户认证模块

采用JWT实现无状态认证，关键代码如下：

java复制// JWT工具类
public class JwtUtil {
    private static final String SECRET = "your-secret-key";
    private static final long EXPIRATION = 86400000; // 24小时
    
    public static String generateToken(UserDetails userDetails) {
        return Jwts.builder()
                .setSubject(userDetails.getUsername())
                .setIssuedAt(new Date())
                .setExpiration(new Date(System.currentTimeMillis() + EXPIRATION))
                .signWith(SignatureAlgorithm.HS512, SECRET)
                .compact();
    }
    
    public static String getUsernameFromToken(String token) {
        return Jwts.parser()
                .setSigningKey(SECRET)
                .parseClaimsJws(token)
                .getBody()
                .getSubject();
    }
}

3.2 小说管理模块

实现小说CRUD操作，使用MyBatis Plus简化开发：

java复制@Service
public class NovelServiceImpl extends ServiceImpl<NovelMapper, Novel> implements NovelService {
    
    @Autowired
    private RedisTemplate<String, Object> redisTemplate;
    
    @Override
    public Page<Novel> getNovelList(int pageNum, int pageSize) {
        String cacheKey = "novel:list:" + pageNum + ":" + pageSize;
        Page<Novel> page = (Page<Novel>) redisTemplate.opsForValue().get(cacheKey);
        
        if (page == null) {
            page = page(new Page<>(pageNum, pageSize));
            redisTemplate.opsForValue().set(cacheKey, page, 1, TimeUnit.HOURS);
        }
        
        return page;
    }
    
    @Override
    @Transactional
    public boolean addNovel(Novel novel) {
        boolean result = save(novel);
        if (result) {
            // 清除相关缓存
            redisTemplate.delete("novel:list:*");
        }
        return result;
    }
}

3.3 购买支付模块

集成微信支付API实现小说购买功能：

java复制@RestController
@RequestMapping("/api/payment")
public class PaymentController {
    
    @Autowired
    private WxPayService wxPayService;
    
    @PostMapping("/create")
    public Result createOrder(@RequestBody PaymentRequest request) {
        try {
            // 1. 创建微信支付订单
            WxPayUnifiedOrderRequest wxRequest = new WxPayUnifiedOrderRequest();
            wxRequest.setBody("小说购买-" + request.getNovelName());
            wxRequest.setOutTradeNo(generateOrderNo());
            wxRequest.setTotalFee(request.getAmount());
            wxRequest.setSpbillCreateIp(request.getClientIp());
            wxRequest.setNotifyUrl("https://yourdomain.com/api/payment/notify");
            wxRequest.setTradeType("JSAPI");
            wxRequest.setOpenid(request.getOpenid());
            
            // 2. 调用微信支付接口
            WxPayUnifiedOrderResult result = wxPayService.unifiedOrder(wxRequest);
            
            // 3. 返回前端需要的支付参数
            Map<String, String> payParams = new HashMap<>();
            payParams.put("appId", result.getAppid());
            payParams.put("timeStamp", String.valueOf(System.currentTimeMillis() / 1000));
            payParams.put("nonceStr", result.getNonceStr());
            payParams.put("package", "prepay_id=" + result.getPrepayId());
            payParams.put("signType", "MD5");
            
            // 4. 生成签名
            String sign = WxPayUtil.generateSignature(payParams, wxPayService.getConfig().getMchKey());
            payParams.put("paySign", sign);
            
            return Result.success(payParams);
        } catch (Exception e) {
            log.error("创建支付订单失败", e);
            return Result.fail("创建支付订单失败");
        }
    }
}

4. 数据库设计

4.1 主要表结构

1. 用户表(user)：

sql复制CREATE TABLE `user` (
  `id` bigint NOT NULL AUTO_INCREMENT,
  `username` varchar(50) NOT NULL COMMENT '用户名',
  `password` varchar(100) NOT NULL COMMENT '密码',
  `nickname` varchar(50) DEFAULT NULL COMMENT '昵称',
  `avatar` varchar(255) DEFAULT NULL COMMENT '头像',
  `email` varchar(100) DEFAULT NULL COMMENT '邮箱',
  `phone` varchar(20) DEFAULT NULL COMMENT '手机号',
  `status` tinyint DEFAULT '1' COMMENT '状态：0-禁用，1-正常',
  `create_time` datetime DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
  `update_time` datetime DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
  PRIMARY KEY (`id`),
  UNIQUE KEY `idx_username` (`username`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='用户表';

2. 小说表(novel)：

sql复制CREATE TABLE `novel` (
  `id` bigint NOT NULL AUTO_INCREMENT,
  `title` varchar(100) NOT NULL COMMENT '小说标题',
  `author` varchar(50) NOT NULL COMMENT '作者',
  `cover` varchar(255) DEFAULT NULL COMMENT '封面图',
  `description` text COMMENT '简介',
  `category_id` bigint DEFAULT NULL COMMENT '分类ID',
  `price` decimal(10,2) DEFAULT '0.00' COMMENT '价格',
  `word_count` int DEFAULT '0' COMMENT '字数',
  `status` tinyint DEFAULT '0' COMMENT '状态：0-连载中，1-已完结',
  `create_time` datetime DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
  `update_time` datetime DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
  PRIMARY KEY (`id`),
  KEY `idx_category` (`category_id`),
  KEY `idx_author` (`author`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='小说表';

3. 章节表(chapter)：

sql复制CREATE TABLE `chapter` (
  `id` bigint NOT NULL AUTO_INCREMENT,
  `novel_id` bigint NOT NULL COMMENT '小说ID',
  `title` varchar(100) NOT NULL COMMENT '章节标题',
  `content` longtext COMMENT '章节内容',
  `is_free` tinyint DEFAULT '0' COMMENT '是否免费：0-收费，1-免费',
  `price` decimal(10,2) DEFAULT '0.00' COMMENT '价格',
  `word_count` int DEFAULT '0' COMMENT '字数',
  `sort` int DEFAULT '0' COMMENT '排序',
  `create_time` datetime DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
  `update_time` datetime DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
  PRIMARY KEY (`id`),
  KEY `idx_novel` (`novel_id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='章节表';

4.2 索引优化

为了提高查询性能，我们在关键字段上建立了索引：

1. 用户表的username字段建立唯一索引
2. 小说表的category_id和author字段建立普通索引
3. 章节表的novel_id字段建立普通索引

对于高频查询但更新不频繁的数据，如小说分类、热门小说列表等，我们使用Redis缓存：

java复制// 获取热门小说列表
public List<Novel> getHotNovels() {
    String cacheKey = "novel:hot";
    List<Novel> novels = (List<Novel>) redisTemplate.opsForValue().get(cacheKey);
    
    if (novels == null) {
        novels = lambdaQuery()
                .orderByDesc(Novel::getClickCount)
                .last("limit 10")
                .list();
        redisTemplate.opsForValue().set(cacheKey, novels, 1, TimeUnit.HOURS);
    }
    
    return novels;
}

5. 性能优化实践

5.1 缓存策略

1. 多级缓存架构：

   • 本地缓存(Caffeine)：缓存用户个性化配置等数据
   • Redis缓存：缓存热点数据如热门小说、排行榜等
   • MySQL：持久化存储

2. 缓存更新策略：

   • 写操作时双删策略：先删缓存再更新数据库，最后再删一次缓存
   • 设置合理的过期时间，避免缓存雪崩

5.2 数据库优化

1. 读写分离：

   • 主库负责写操作
   • 从库负责读操作
   • 使用Sharding-JDBC实现透明访问

2. SQL优化：

   • 避免SELECT *
   • 合理使用索引
   • 批量操作代替循环单条操作

java复制// 批量插入章节
@Transactional
public void batchInsertChapters(List<Chapter> chapters) {
    if (CollectionUtils.isEmpty(chapters)) {
        return;
    }
    
    String sql = "INSERT INTO chapter (novel_id, title, content, is_free, price, word_count, sort) " +
                 "VALUES (?, ?, ?, ?, ?, ?, ?)";
    
    jdbcTemplate.batchUpdate(sql, new BatchPreparedStatementSetter() {
        @Override
        public void setValues(PreparedStatement ps, int i) throws SQLException {
            Chapter chapter = chapters.get(i);
            ps.setLong(1, chapter.getNovelId());
            ps.setString(2, chapter.getTitle());
            ps.setString(3, chapter.getContent());
            ps.setInt(4, chapter.getIsFree());
            ps.setBigDecimal(5, chapter.getPrice());
            ps.setInt(6, chapter.getWordCount());
            ps.setInt(7, chapter.getSort());
        }
        
        @Override
        public int getBatchSize() {
            return chapters.size();
        }
    });
}

5.3 前端性能优化

1. 图片懒加载：

html复制<image 
  lazy-load 
  src="{{novel.cover}}" 
  mode="aspectFill"
></image>

2. 分页加载：

javascript复制Page({
  data: {
    novels: [],
    page: 1,
    loading: false,
    noMore: false
  },
  
  onReachBottom() {
    if (this.data.loading || this.data.noMore) return;
    
    this.setData({ loading: true });
    this.loadMoreNovels();
  },
  
  loadMoreNovels() {
    const { page } = this.data;
    wx.request({
      url: 'https://yourdomain.com/api/novels',
      data: { page },
      success: (res) => {
        const newNovels = res.data.list;
        this.setData({
          novels: [...this.data.novels, ...newNovels],
          page: page + 1,
          noMore: newNovels.length === 0
        });
      },
      complete: () => {
        this.setData({ loading: false });
      }
    });
  }
})

6. 安全防护措施

6.1 常见安全防护

1. XSS防护：

   • 前端使用wxParse组件时对内容进行过滤
   • 后端对所有用户输入进行HTML转义

2. CSRF防护：

   • 使用JWT并在请求头中传递
   • 校验Referer头

3. SQL注入防护：

   • 使用MyBatis Plus提供的Wrapper进行条件构造
   • 禁止拼接SQL语句

6.2 敏感数据保护

1. 密码加密存储：

java复制// 密码加密
public String encryptPassword(String password) {
    return new BCryptPasswordEncoder().encode(password);
}

// 密码验证
public boolean checkPassword(String rawPassword, String encodedPassword) {
    return new BCryptPasswordEncoder().matches(rawPassword, encodedPassword);
}

2. 敏感信息脱敏：

java复制// 手机号脱敏
public static String desensitizePhone(String phone) {
    if (StringUtils.isBlank(phone) || phone.length() != 11) {
        return phone;
    }
    return phone.substring(0, 3) + "****" + phone.substring(7);
}

3. 接口限流：

java复制@RestController
@RequestMapping("/api/novel")
public class NovelController {
    
    @RateLimiter(value = 100, key = "novel:detail:#{novelId}")
    @GetMapping("/detail/{novelId}")
    public Result getNovelDetail(@PathVariable Long novelId) {
        // 获取小说详情逻辑
    }
}

7. 部署与监控

7.1 容器化部署

使用Docker Compose编排服务：

yaml复制version: '3.8'

services:
  mysql:
    image: mysql:8.0
    container_name: novel-mysql
    environment:
      MYSQL_ROOT_PASSWORD: yourpassword
      MYSQL_DATABASE: novel_db
    ports:
      - "3306:3306"
    volumes:
      - ./mysql/data:/var/lib/mysql
      - ./mysql/conf:/etc/mysql/conf.d
    restart: always

  redis:
    image: redis:7.0
    container_name: novel-redis
    ports:
      - "6379:6379"
    volumes:
      - ./redis/data:/data
    restart: always

  novel-api:
    build: .
    container_name: novel-api
    ports:
      - "8080:8080"
    environment:
      - SPRING_PROFILES_ACTIVE=prod
    depends_on:
      - mysql
      - redis
    restart: always

7.2 监控方案

1. Spring Boot Actuator：

yaml复制management:
  endpoints:
    web:
      exposure:
        include: health,info,metrics,prometheus
  endpoint:
    health:
      show-details: always
    prometheus:
      enabled: true

2. Prometheus + Grafana监控：

   • Prometheus采集指标数据
   • Grafana展示监控图表

3. ELK日志收集：

   • Filebeat收集日志
   • Logstash处理日志
   • Elasticsearch存储日志
   • Kibana展示日志

8. 开发经验与心得

8.1 开发中的坑与解决方案

1. 微信支付回调问题：

   • 问题：微信支付回调有时收不到
   • 原因：内网穿透导致回调地址不可达
   • 解决：使用ngrok等工具生成公网可访问的临时域名

2. 分页缓存问题：

   • 问题：小说列表分页缓存占用大量内存
   • 解决：只缓存前几页数据，后面的动态查询

3. 事务失效问题：

   • 问题：@Transactional注解在某些情况下不生效
   • 原因：自调用或异常被捕获
   • 解决：避免自调用，正确处理异常

8.2 性能优化建议

1. 对于小说内容这类大文本字段：

   • 考虑单独存储，避免影响主表查询性能
   • 使用MySQL的TEXT类型或考虑MongoDB存储

2. 搜索功能优化：

   • 简单搜索：使用MySQL的LIKE
   • 高级搜索：集成Elasticsearch

3. 静态资源处理：

   • 使用CDN加速
   • 图片使用WebP格式减小体积

8.3 项目扩展方向

1. 社交功能：

   • 读者评论互动
   • 作者粉丝系统
   • 书友圈

2. 推荐系统：

   • 基于内容的推荐
   • 协同过滤推荐
   • 混合推荐算法

3. 多端适配：

   • H5版本
   • 安卓/iOS App
   • PC网页版

这个项目从零开始搭建，过程中遇到了各种技术挑战，但通过不断学习和实践都得到了解决。Spring Boot 3的稳定性和开发效率给我留下了深刻印象，微信小程序的生态也越来越完善。希望我的这些经验能对正在开发类似项目的同行有所帮助。