自定义Maven目录结构指定sourceDirectory仍提示无源码可编译

这问题我碰到过好几次了，核心原因是Maven默认只认src/main/java这类标准目录，你自定义的目录必须明确告诉Maven它该去哪找源码才行。

解决办法：在pom.xml中显式配置源码目录 #

你需要在<build>节点下添加sourceDirectory（主源码）和testSourceDirectory（测试源码，如果有的话）配置，指定你的自定义路径。示例配置如下：

<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <!-- 项目基础信息、依赖等其他配置 -->

    <build>
        <!-- 指定主源码目录：替换成你实际的java目录路径 -->
        <sourceDirectory>${project.basedir}/java</sourceDirectory>
        
        <!-- 如果有测试源码，同样指定自定义路径（比如java/test） -->
        <testSourceDirectory>${project.basedir}/java/test</testSourceDirectory>

        <!-- 可选：如果有自定义资源文件目录，也可以一起配置 -->
        <resources>
            <resource>
                <directory>${project.basedir}/resources</directory>
            </resource>
        </resources>
        <testResources>
            <testResource>
                <directory>${project.basedir}/test-resources</directory>
            </testResource>
        </testResources>
    </build>
</project>

关键细节说明 #

• ${project.basedir}是Maven内置变量，代表项目根目录，用它代替硬编码路径更灵活，跨环境也不容易出错。
• 一定要保证配置的路径和你实际的目录完全匹配，比如你的java目录如果在src/java下，就改成${project.basedir}/src/java，注意大小写（Linux/Mac系统路径大小写敏感）。

验证步骤 #

1. 先执行mvn clean compile，观察控制台输出，如果看到类似Compiling X source files的日志，说明源码已经被正确识别并编译了。
2. 再执行mvn clean package，此时生成的Jar包就会包含编译后的class文件，不会是空包了。

如果还是有问题，先检查自定义目录下是否真的存在.java源码文件，或者路径有没有拼写错误。

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