← 返回学习路线

SYSTEM

清理后的完整配置

后端实战五、清理后的完整配置blog-dev
src/content/notes/blog-dev/清理后的完整配置.md

五、清理后的完整配置

1. bootstrap.yml(blog-user-service)

spring:
  application:
    name: blog-user-service
  cloud:
    nacos:
      server-addr: ${NACOS_ADDR:localhost:8848}
      namespace: ${NACOS_NAMESPACE:}
      config:
        file-extension: yaml
        group: DEFAULT_GROUP
        refresh-enabled: true
        shared-configs:
          - dataId: blog-common.yaml
            group: DEFAULT_GROUP
            refresh: true
      discovery:
        ephemeral: true
management:
  endpoints:
    web:
      exposure:
        include: '*'

2. application.yml(清理后)

server:
  port: 8081

spring:
  application:
    name: blog-user-service
  datasource:
    url: jdbc:mysql://${DB_HOST:localhost}:${DB_PORT:3306}/blog_db?useSSL=false&serverTimezone=Asia/Shanghai&allowPublicKeyRetrieval=true
    username: ${DB_USERNAME:root}
    password:[已隐藏]
    driver-class-name: com.mysql.cj.jdbc.Driver
  jpa:
    hibernate:
      ddl-auto: none
    show-sql: false
    properties:
      hibernate:
        dialect: org.hibernate.dialect.MySQLDialect
  data:
    redis:
      host: ${REDIS_HOST:localhost}
      port: ${REDIS_PORT:6379}
      password:[已隐藏]
      database: 0
      timeout: 10000ms
      lettuce:
        pool:
          max-active: 8
          max-wait: -1ms
          max-idle: 8
          min-idle: 2
  cloud:
    nacos:
      discovery:
        server-addr: localhost:8848

cors:
  allowed-origins: ${CORS_ALLOWED_ORIGINS:http://localhost:5173}

jwt:
  secret-key: ${JWT_SECRET_KEY:MySecretKeyForJWTTokenGeneration2026BlogProject-DevOnly}
  expiration-time: 86400000

关键变更:删除了 Nacos 端点排除、REDIS_PASSWORD 默认值改为 #{null}。

3. RedisConfig.java(清理后,仅保留 RedisTemplate)

@Configuration
public class RedisConfig {

    @Bean
    public RedisTemplate<String, Object> redisTemplate(RedisConnectionFactory factory) {
        RedisTemplate<String, Object> template = new RedisTemplate<>();
        template.setConnectionFactory(factory);

        ObjectMapper objectMapper = new ObjectMapper();
        objectMapper.registerModule(new JavaTimeModule());
        objectMapper.disable(SerializationFeature.WRITE_DATES_AS_TIMESTAMPS);
        objectMapper.activateDefaultTyping(
                objectMapper.getPolymorphicTypeValidator(),
                ObjectMapper.DefaultTyping.NON_FINAL
        );
        objectMapper.setVisibility(PropertyAccessor.ALL, JsonAutoDetect.Visibility.ANY);

        GenericJackson2JsonRedisSerializer jsonSerializer =
                new GenericJackson2JsonRedisSerializer(objectMapper);
        StringRedisSerializer stringSerializer = new StringRedisSerializer();

        template.setKeySerializer(stringSerializer);
        template.setHashKeySerializer(stringSerializer);
        template.setValueSerializer(jsonSerializer);
        template.setHashValueSerializer(jsonSerializer);

        template.afterPropertiesSet();
        return template;
    }
}

关键变更:删除了 redissonClient() 方法及所有 @Value 字段。RedissonClient 由 redisson-spring-boot-starter 自动装配。

4. RedisUtil.java deleteByPattern(清理后)

public void deleteByPattern(String pattern) {
    ScanOptions options = ScanOptions.scanOptions().match(pattern).count(500).build();
    try (Cursor<String> cursor = redisTemplate.scan(options)) {
        while (cursor.hasNext()) {
            redisTemplate.delete(cursor.next());
        }
    } catch (Exception e) {
        Set<String> keys = redisTemplate.keys(pattern);
        if (keys != null && !keys.isEmpty()) {
            redisTemplate.delete(keys);
        }
    }
}

关键变更:getConnectionFactory().getConnection().scan() → redisTemplate.scan(),返回类型从 Cursor<byte[]> 变为 Cursor<String>。


六、全流程验证校验清单

1. 编译层

mvn -pl blog-user-service -am clean compile

输出 BUILD SUCCESS。

2. 启动日志分层校验

  1. Spring Boot 3.5.4 横幅;
  2. Nacos 拉取 blog-common.yaml 公共配置日志;
  3. 无占位符解析异常、无 Redis AUTH 异常;
  4. RedissonClient 由 Starter 自动装配(无手动 Bean 日志);
  5. Tomcat 8081 端口初始化完成。

3. 功能分层测试

  1. JWT 登录接口:正常签发 Token;
  2. RedisTemplate:缓存读写正常;
  3. RedissonClient:分布式锁正常获取(自动装配的 Bean);
  4. JPA 数据库:正常连接 MySQL;
  5. Nacos 动态刷新:修改配置后服务自动感知。

4. 持久化校验

删除 nacos 容器 → 重新挂载数据卷启动 → Nacos 控制台仍存在 blog-common.yaml。


七、改造优化总结与生产规范

  1. 版本规范:父工程统一锁定全套 Spring Boot、Cloud Alibaba、中间件版本,子模块禁止自定义 version;
  2. 配置分层规范:公共配置 → Nacos 共享配置,私有配置 → 本地 application.yml;
  3. Redis 客户端规范:SB 3.5.4 下 redisson-spring-boot-starter 自动配置完全可用,无需手动创建 Bean。Lettuce 负责业务缓存,Redisson 负责分布式锁,各司其职;
  4. 占位符安全规范:密码类配置默认值用 #{null} 而非空字符串,避免空串 AUTH;
  5. 容器持久化规范:Docker 中间件必须挂载本地数据卷;
  6. 开发调试规范:IDE 静态警告仅作参考,以命令行编译 + 启动日志为准;
  7. 安全规范:生产环境全部开启鉴权,敏感配置通过环境变量注入。