IntelliJ无法解析@Testcontainers等符号，pom依赖配置正常求助

问题概述 #

IntelliJ IDEA持续提示“Cannot resolve symbol 'Testcontainers'”，无法识别@Testcontainers、@Container注解和MySQLContainer类，但pom.xml依赖配置正确，且mvn dependency:tree输出显示依赖已成功解析。

环境详情 #

• IntelliJ IDEA 21.0.9
• Java 25
• Spring Boot 3.4.5
• Windows 11
• Maven（IntelliJ内置版本）

依赖确认 #

执行mvn dependency:tree得到以下输出，确认Testcontainers相关依赖已加载：

[INFO] +- org.testcontainers:junit-jupiter:jar:1.20.5:test
[INFO] | \- org.testcontainers:testcontainers:jar:1.20.6:test
[INFO] +- org.testcontainers:mysql:jar:1.20.5:test

pom.xml依赖配置 #

<dependency>
    <groupId>org.testcontainers</groupId>
    <artifactId>junit-jupiter</artifactId>
    <version>1.20.5</version>
    <scope>test</scope>
</dependency>

<dependency>
    <groupId>org.testcontainers</groupId>
    <artifactId>mysql</artifactId>
    <version>1.20.5</version>
    <scope>test</scope>
</dependency>

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-test</artifactId>
    <scope>test</scope>
    <exclusions>
        <exclusion>
            <groupId>org.junit.vintage</groupId>
            <artifactId>junit-vintage-engine</artifactId>
        </exclusion>
    </exclusions>
</dependency>

报错代码示例 #

import org.testcontainers.junit.jupiter.Testcontainers; // Cannot resolve
import org.testcontainers.junit.jupiter.Container;      // Cannot resolve
import org.testcontainers.containers.MySQLContainer;    // Cannot resolve

@Testcontainers
@SpringBootTest(webEnvironment = SpringBootTest.WebEnvironment.RANDOM_PORT)
public class ArtistControllerIT { ... }

已尝试无效操作 #

• 重新加载所有Maven项目
• 清除IntelliJ缓存并重启
• 删除.idea文件夹后重新导入项目
• 移除重复的spring-boot-starter-test依赖（曾无test作用域重复声明）
• 执行mvn dependency:resolve无报错

解决步骤 #

以下是最终解决该问题的有效方案：

1. 检查测试类目录：确保测试类位于src/test/java目录下，Testcontainers依赖的scope为test，仅测试目录下的类才能识别这些依赖。
2. 适配Java版本：Testcontainers 1.20.x与Java 25可能存在兼容性问题，可尝试降级至Java 21（LTS版本），或升级Testcontainers至最新兼容版本。
3. 验证IDE依赖配置：
   打开File → Project Structure → Modules，选中对应模块切换到Dependencies标签页，确认test作用域下的Testcontainers依赖已正确加载，若缺失则手动添加或重新导入Maven项目。
4. 强制刷新Maven资源：
   在IntelliJ右侧Maven面板，点击Reload All Maven Projects旁的下拉箭头，选择Generate Sources and Update Folders For All Projects，强制刷新依赖与目录结构。

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