IntelliJ报错：Package指令与文件位置不匹配的技术求助

1. 修正IDE的Kotlin源目录识别 #

打开IDE的Project Structure（快捷键Ctrl+Alt+Shift+S），找到对应模块的Sources标签：

• 找到src/main/kotlin目录，右键设为Sources Root
• 找到src/test/kotlin目录，右键设为Test Sources Root
  确保src/main/java仅标记为Java的Sources Root，避免Kotlin文件被错误识别为Java目录下的文件。

2. 检查并修复Maven的Kotlin插件配置 #

打开项目根目录的pom.xml，确认kotlin-maven-plugin配置正确，核心配置示例：

<build>
    <plugins>
        <plugin>
            <groupId>org.jetbrains.kotlin</groupId>
            <artifactId>kotlin-maven-plugin</artifactId>
            <version>${kotlin.version}</version>
            <executions>
                <execution>
                    <id>compile</id>
                    <phase>compile</phase>
                    <goals>
                        <goal>compile</goal>
                    </goals>
                    <configuration>
                        <sourceDirs>
                            <sourceDir>${project.basedir}/src/main/kotlin</sourceDir>
                            <sourceDir>${project.basedir}/src/main/java</sourceDir>
                        </sourceDirs>
                    </configuration>
                </execution>
                <execution>
                    <id>test-compile</id>
                    <phase>test-compile</phase>
                    <goals>
                        <goal>test-compile</goal>
                    </goals>
                    <configuration>
                        <sourceDirs>
                            <sourceDir>${project.basedir}/src/test/kotlin</sourceDir>
                            <sourceDir>${project.basedir}/src/test/java</sourceDir>
                        </sourceDirs>
                    </configuration>
                </execution>
            </executions>
        </plugin>
    </plugins>
</build>

重点确保sourceDirs包含Kotlin的源目录，同时关联Java目录以支持混编。

3. 清除IDE缓存并重新导入项目 #

• 点击File -> Invalidate Caches...，勾选Clear file system cache and local history，点击Invalidate and Restart
• 重启后，右键项目根目录的pom.xml，选择Maven -> Reload Project，强制IDE重新读取Maven配置并同步源目录。

4. 验证文件路径与包名一致性 #

如果报错文件的包声明是package e2e.utils，那么该文件的物理路径必须是项目根目录/src/main/kotlin/e2e/utils/xxx.kt，不要将Kotlin文件放在src/main/java目录下，否则IDE会错误关联包名到Java目录结构。

• 贴出报错Kotlin文件的顶部包声明代码，以及该文件在本地的完整物理路径（比如~/projects/xxx/src/main/kotlin/e2e/utils/Helper.kt）
• 贴出pom.xml中kotlin-maven-plugin的完整配置代码段
• 截取IDE中Project Structure -> Modules -> Sources标签页的截图，展示所有源目录的标记情况
• 贴出出现Unresolved reference错误的具体代码行，以及被引用类的包名和物理路径

内容的提问来源于stack exchange，提问作者Frank H.