普兆健康管家后端代码仓库

6.5 KiB

Raw Blame History

小程序模块配置说明

概述

本文档说明小程序登录服务需要配置的内容，包括数据库、Redis、微信配置等。

1. 数据库配置

1.1 数据库表结构

需要确保 applet_user 表已创建，表结构如下：

CREATE TABLE `applet_user` (
  `id` varchar(32) NOT NULL COMMENT '主键',
  `create_by` varchar(50) DEFAULT NULL COMMENT '创建人',
  `create_time` datetime DEFAULT NULL COMMENT '创建日期',
  `update_by` varchar(50) DEFAULT NULL COMMENT '更新人',
  `update_time` datetime DEFAULT NULL COMMENT '更新日期',
  `sys_org_code` varchar(64) DEFAULT NULL COMMENT '所属部门',
  `name` varchar(100) DEFAULT NULL COMMENT '昵称',
  `openid` varchar(100) DEFAULT NULL COMMENT '第三方认证id',
  `phone` varchar(20) DEFAULT NULL COMMENT '手机号',
  `bmi` decimal(10,2) DEFAULT NULL COMMENT '体总指数',
  `fat` decimal(10,2) DEFAULT NULL COMMENT '脂肪',
  `avatar` varchar(500) DEFAULT NULL COMMENT '头像',
  PRIMARY KEY (`id`),
  UNIQUE KEY `uk_openid` (`openid`),
  UNIQUE KEY `uk_phone` (`phone`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='小程序用户表';

1.2 数据库连接配置

在 application.yml 中配置数据库连接：

spring:
  datasource:
    url: jdbc:mysql://localhost:3306/jeecg-boot?useUnicode=true&characterEncoding=utf8&zeroDateTimeBehavior=convertToNull&useSSL=true&serverTimezone=GMT%2B8
    username: root
    password: root
    driver-class-name: com.mysql.cj.jdbc.Driver

2. Redis配置

2.1 Redis连接配置

在 application.yml 中配置Redis：

spring:
  redis:
    host: localhost
    port: 6379
    password: 
    database: 0
    timeout: 10000ms
    lettuce:
      pool:
        max-active: 8
        max-wait: -1ms
        max-idle: 8
        min-idle: 0

2.2 Redis配置类

需要创建Redis配置类：

@Configuration
public class RedisConfig {
    
    @Bean
    public RedisTemplate<String, Object> redisTemplate(RedisConnectionFactory factory) {
        RedisTemplate<String, Object> template = new RedisTemplate<>();
        template.setConnectionFactory(factory);
        
        // 设置key的序列化方式
        template.setKeySerializer(new StringRedisSerializer());
        // 设置value的序列化方式
        template.setValueSerializer(new GenericJackson2JsonRedisSerializer());
        // 设置hash key的序列化方式
        template.setHashKeySerializer(new StringRedisSerializer());
        // 设置hash value的序列化方式
        template.setHashValueSerializer(new GenericJackson2JsonRedisSerializer());
        
        template.afterPropertiesSet();
        return template;
    }
}

3. 微信小程序配置

3.1 微信配置

在 application.yml 中配置微信小程序信息：

wechat:
  mpAppId: your_applet_appid
  mpAppSecret: your_applet_secret
  merchantId: your_merchant_id  # 如果需要支付功能

3.2 微信配置类

确保 WxHttpUtils 类能正确读取配置：

@Component
public class WxHttpUtils {
    @Value("${wechat.mpAppId}")
    private String appid;
    
    @Value("${wechat.mpAppSecret}")
    private String secret;
}

4. JWT配置

4.1 JWT密钥配置

在 application.yml 中配置JWT密钥：

jeecg:
  jwt:
    secret: your_jwt_secret_key
    expire: 604800  # 7天，单位秒

4.2 JWT工具类配置

确保 JwtUtil 类能正确读取配置：

@Component
public class JwtUtil {
    @Value("${jeecg.jwt.secret}")
    private String secret;
    
    @Value("${jeecg.jwt.expire}")
    private long expire;
}

5. 日志配置

5.1 日志级别配置

在 application.yml 中配置日志级别：

logging:
  level:
    org.jeecg.modules.applet: DEBUG
    org.jeecg.modules.common.wxUtils: DEBUG

6. 安全配置

6.1 CORS配置

如果需要跨域访问，需要配置CORS：

@Configuration
public class CorsConfig {
    
    @Bean
    public CorsFilter corsFilter() {
        CorsConfiguration config = new CorsConfiguration();
        config.addAllowedOrigin("*");
        config.addAllowedHeader("*");
        config.addAllowedMethod("*");
        
        UrlBasedCorsConfigurationSource source = new UrlBasedCorsConfigurationSource();
        source.registerCorsConfiguration("/**", config);
        
        return new CorsFilter(source);
    }
}

7. 依赖配置

7.1 Maven依赖

确保 pom.xml 中包含以下依赖：

<!-- Redis -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-data-redis</artifactId>
</dependency>

<!-- HTTP客户端 -->
<dependency>
    <groupId>org.apache.httpcomponents</groupId>
    <artifactId>httpclient</artifactId>
</dependency>

<!-- JSON处理 -->
<dependency>
    <groupId>com.alibaba</groupId>
    <artifactId>fastjson</artifactId>
</dependency>

<!-- MyBatis Plus -->
<dependency>
    <groupId>com.baomidou</groupId>
    <artifactId>mybatis-plus-boot-starter</artifactId>
</dependency>

8. 环境变量配置

8.1 生产环境配置

在生产环境中，建议使用环境变量或配置中心来管理敏感信息：

wechat:
  mpAppId: ${WECHAT_MP_APPID:default_appid}
  mpAppSecret: ${WECHAT_MP_SECRET:default_secret}

spring:
  redis:
    host: ${REDIS_HOST:localhost}
    port: ${REDIS_PORT:6379}
    password: ${REDIS_PASSWORD:}

9. 监控配置

9.1 健康检查

可以添加健康检查端点：

management:
  endpoints:
    web:
      exposure:
        include: health,info,metrics
  endpoint:
    health:
      show-details: always

10. 注意事项

安全性：生产环境中不要将敏感信息硬编码在代码中
性能：Redis连接池配置要根据实际负载调整
监控：建议添加应用监控和日志收集
备份：定期备份数据库和Redis数据
测试：在部署前进行充分的测试

11. 常见问题

11.1 Redis连接失败

检查Redis服务是否启动
检查网络连接和防火墙设置
检查Redis配置是否正确

11.2 微信API调用失败

检查微信小程序配置是否正确
检查网络连接是否正常
检查微信API调用频率限制

11.3 数据库连接失败

检查数据库服务是否启动
检查数据库连接配置
检查数据库用户权限

12. 部署检查清单

数据库表已创建
Redis服务已启动
微信小程序配置正确
JWT密钥已配置
日志配置正确
网络连接正常
安全配置已设置
监控已配置
备份策略已制定

6.5 KiB Raw Blame History