如何测试Spring组件SecurityUtility类？固定种子测试报错排查

首先，咱们先解决你当前测试失败的核心问题，再一步步拆解这个类的测试思路和正确实现方式。

一、你的测试失败原因排查 #

你当前的测试代码和原业务代码存在两个关键问题：

1. 依赖未复用：randomPassword()方法内部自己new Random()，完全没用到类中通过构造注入的random字段！这就导致你在测试里设置的固定种子new Random(1)根本不起作用，每次运行生成的密码都是随机的，自然和预期值对不上。
2. 索引越界风险：原代码里int index = rnd.nextInt() * SALTCHARS.length();会生成负数索引（nextInt()可能返回负数），调用charAt(index)会直接抛出StringIndexOutOfBoundsException，这是隐藏的bug。

先修复原业务代码的设计问题，这是测试的前提：

@Component
public class SecurityUtility {
    private final String SALT = "salt";
    private final Random random;
    // 把常量提取到类级别，避免重复创建
    private static final String SALTCHARS = "ABCDEFGHIJKLMNOPQRSTUVWXYZ1234567890";

    // 构造注入Random，确保全类复用同一个实例
    public SecurityUtility(Random random) {
        this.random = random;
    }

    @Bean
    public BCryptPasswordEncoder passwordEncoder() {
        return new BCryptPasswordEncoder(12, new SecureRandom(SALT.getBytes()));
    }

    public String randomPassword() {
        StringBuilder stringBuilder = new StringBuilder();
        while (stringBuilder.length() < 18) {
            // 使用nextInt(int bound)直接生成0到bound-1的合法索引，避免负数
            int index = random.nextInt(SALTCHARS.length());
            stringBuilder.append(SALTCHARS.charAt(index));
        }
        return stringBuilder.toString();
    }
}

二、适用的测试类型及实施方法 #

针对这个组件，我们可以分单元测试（验证业务逻辑）和集成测试（验证Spring上下文配置）两类来做。

1. 单元测试（无需Spring上下文，快速验证逻辑） #

这类测试专注于单个方法的逻辑，不需要启动Spring容器，用JUnit就能完成。

测试randomPassword()方法

现在代码复用了注入的Random，我们可以用固定种子的Random来做确定性测试：

import org.junit.Test;
import java.util.Random;
import static org.junit.Assert.*;

public class SecurityUtilityUnitTest {

    @Test
    public void randomPassword_WithFixedSeed_ReturnsStableValue() {
        // 使用固定种子的Random，确保每次生成的随机序列完全一致
        Random fixedSeedRandom = new Random(1L);
        SecurityUtility utility = new SecurityUtility(fixedSeedRandom);
        
        // 这个值是固定种子1生成的稳定结果，现在每次运行都会返回它
        String expected = "Z49G2RLF0HJNNWZQCP";
        String actual = utility.randomPassword();
        
        assertEquals("固定种子应生成预期密码", expected, actual);
    }

    @Test
    public void randomPassword_ShouldHaveCorrectLength() {
        SecurityUtility utility = new SecurityUtility(new Random());
        assertEquals("随机密码长度必须为18", 18, utility.randomPassword().length());
    }

    @Test
    public void randomPassword_OnlyContainsAllowedCharacters() {
        SecurityUtility utility = new SecurityUtility(new Random());
        String password = utility.randomPassword();
        // 验证所有字符都在允许的范围内
        assertTrue(password.matches("[A-Z0-9]+"));
    }
}

测试passwordEncoder()方法

验证Bean的配置是否符合预期：

@Test
public void passwordEncoder_ReturnsConfiguredBCryptInstance() {
    SecurityUtility utility = new SecurityUtility(new Random());
    BCryptPasswordEncoder encoder = utility.passwordEncoder();
    
    // 验证加密强度是12
    assertEquals(12, encoder.getStrength());
    // 验证BCrypt的密码格式正确性
    String encoded = encoder.encode("test123");
    assertTrue(encoded.startsWith("$2a$12$") || encoded.startsWith("$2b$12$"));
}

2. 集成测试（验证Spring上下文的Bean配置） #

如果你需要验证这个组件作为Spring Bean被正确注入，以及BCryptPasswordEncoder Bean是否正常工作，可以用Spring Boot的集成测试：

import org.junit.Test;
import org.junit.runner.RunWith;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.context.SpringBootTest;
import org.springframework.test.context.junit4.SpringRunner;
import static org.junit.Assert.*;

@RunWith(SpringRunner.class)
@SpringBootTest(classes = SecurityUtility.class)
public class SecurityUtilityIntegrationTest {

    @Autowired
    private SecurityUtility securityUtility;

    @Autowired
    private BCryptPasswordEncoder passwordEncoder;

    @Test
    public void contextLoads_ComponentsAreProperlyAutowired() {
        assertNotNull("SecurityUtility Bean应被成功注入", securityUtility);
        assertNotNull("BCryptPasswordEncoder Bean应被成功注册", passwordEncoder);
    }

    @Test
    public void passwordEncoder_CanEncryptAndVerifyPassword() {
        String rawPassword = "mySecurePassword123";
        String encoded = passwordEncoder.encode(rawPassword);
        
        // 验证原密码能匹配加密后的结果
        assertTrue(passwordEncoder.matches(rawPassword, encoded));
        // 验证错误密码无法匹配
        assertFalse(passwordEncoder.matches("wrongPassword", encoded));
    }
}

内容的提问来源于stack exchange，提问作者valik