加载属性文件的服务Mock单元测试失败排查与解决（新手求助）

阿华AIGC实验室

2026-5-15

问题排查与修复：PhoneCodeService单元测试无法运行的原因

让我来帮你梳理下问题所在，以及对应的修复方案：

核心问题分析

你的单元测试无法正常运行，主要有这几个关键原因：

1. 错误使用@Mock注解

你要测试的是PhoneCodeService本身的功能，但你用了@Mock来创建实例——Mock对象是用来模拟依赖服务的，而不是你要测试的目标类。用@Mock生成的实例是一个完全模拟的空壳，所有方法默认返回null（除了你手动指定的when逻辑），这意味着你根本没在测试真实的属性加载和编码查询逻辑。

2. 属性文件加载路径问题

在单元测试环境中，Thread.currentThread().getContextClassLoader().getResourceAsStream()会从测试类路径加载文件。如果你的phone-code.properties只放在了src/main/resources下，没复制到src/test/resources，测试时就会加载失败，导致phoneCodes是空Map，查询自然返回null。

3. 异常处理不够直观

构造函数里捕获IOException只打了debug日志，测试时如果没开启debug级别日志，你根本不知道属性文件加载失败了，排查问题会非常被动。

修复方案

根据你的需求，我提供两种修复思路，你可以根据场景选择：

方案一：测试真实服务实例（简单直接，适合验证文件加载逻辑）

这种方案不需要修改服务类，只需要调整单元测试，并确保测试环境能加载到属性文件：

步骤1：修改单元测试类

去掉@Mock，创建真实的PhoneCodeService实例：

import org.junit.Before;
import org.junit.Test;
import static org.junit.Assert.assertEquals;

public class PhoneCodeServiceTest {
    private PhoneCodeService phoneCodeService;

    @Before
    public void setUp() {
        // 创建真实的服务实例，测试时会自动加载属性文件
        phoneCodeService = new PhoneCodeService();
    }

    @Test
    public void testNullInput() {
        assertEquals(null, phoneCodeService.getPhonecode(null));
    }

    @Test
    public void testExistingCode() {
        // 这里要和测试属性文件里的内容对应
        assertEquals("984", phoneCodeService.getPhonecode("86101"));
    }

    @Test
    public void testNonExistingCode() {
        // 验证不存在的编码返回null
        assertEquals(null, phoneCodeService.getPhonecode("invalid-code"));
    }
}

步骤2：确保属性文件在测试类路径下

把phone-code.properties复制到src/test/resources目录下（如果没有这个目录就新建一个），这样测试时就能正确加载到文件。

方案二：重构服务类，实现可测试性（推荐，解耦文件依赖）

这种方案通过重构服务类，让属性加载逻辑可注入，测试时不需要依赖真实文件，更符合单元测试的隔离原则：

步骤1：重构PhoneCodeService

新增一个带Properties参数的构造函数，用于测试时注入自定义属性；同时优化异常处理和Map的安全性：

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import java.io.FileNotFoundException;
import java.io.IOException;
import java.io.InputStream;
import java.util.Collections;
import java.util.HashMap;
import java.util.Map;
import java.util.Properties;
import org.apache.commons.io.IOUtils;

public class PhoneCodeService {
    private static final Logger LOG = LoggerFactory.getLogger(PhoneCodeService.class);
    private static final String PROPERTY_FILE_NAME = "phone-code.properties";
    private final Map<String, String> phoneCodes;

    /**
     * 生产环境构造函数：自动从属性文件加载编码
     */
    public PhoneCodeService() {
        this(loadPropertiesFromFile());
    }

    /**
     * 测试环境构造函数：允许传入自定义Properties，解耦文件依赖
     */
    public PhoneCodeService(Properties properties) {
        Map<String, String> map = new HashMap<>();
        for (String key : properties.stringPropertyNames()) {
            map.put(key, properties.getProperty(key));
        }
        // 把Map改成不可变，避免后续被修改，提高安全性
        phoneCodes = Collections.unmodifiableMap(map);
    }

    public String getPhonecode(final String input) {
        return phoneCodes.get(input);
    }

    private static Properties loadPropertiesFromFile() {
        Properties properties = new Properties();
        InputStream inputStream = null;
        try {
            inputStream = Thread.currentThread().getContextClassLoader().getResourceAsStream(PROPERTY_FILE_NAME);
            if (inputStream == null) {
                throw new FileNotFoundException("Property file '" + PROPERTY_FILE_NAME + "' is missing from classpath");
            }
            properties.load(inputStream);
        } catch (IOException e) {
            // 改成error日志，加载失败时更显眼
            LOG.error("Failed to load phone code property file", e);
            // 抛出异常，避免服务处于无效状态
            throw new IllegalStateException("Could not initialize PhoneCodeService", e);
        } finally {
            IOUtils.closeQuietly(inputStream);
        }
        return properties;
    }
}

步骤2：编写隔离的单元测试

测试时直接传入测试用的Properties，不需要依赖真实文件：

import org.junit.Before;
import org.junit.Test;
import java.util.Properties;
import static org.junit.Assert.assertEquals;

public class PhoneCodeServiceTest {
    private PhoneCodeService phoneCodeService;

    @Before
    public void setUp() {
        // 手动创建测试用的属性
        Properties testProps = new Properties();
        testProps.setProperty("86101", "984");
        testProps.setProperty("000", "1");
        testProps.setProperty("001", "2");
        
        // 用测试属性初始化服务
        phoneCodeService = new PhoneCodeService(testProps);
    }

    @Test
    public void testNullInputReturnsNull() {
        assertEquals(null, phoneCodeService.getPhonecode(null));
    }

    @Test
    public void testExistingCodesReturnCorrectValue() {
        assertEquals("984", phoneCodeService.getPhonecode("86101"));
        assertEquals("1", phoneCodeService.getPhonecode("000"));
    }

    @Test
    public void testNonExistingCodeReturnsNull() {
        assertEquals(null, phoneCodeService.getPhonecode("99999"));
    }
}