Maven父模块下Java Azure Functions子模块依赖缺失引发类找不到异常

我之前也碰到过几乎一模一样的问题！在多模块Maven结构里，Azure Functions子模块明明编译时能找到本地依赖模块，但运行时就抛出ClassNotFoundException，根源在于Azure Functions的Maven插件在打包部署时，没有正确把本地子模块的jar包复制到运行时的lib目录里。以下是我亲测有效的解决步骤：

1. 确认基础依赖配置正确 #

首先检查两个子模块的pom.xml：

• 确保dependency-module的打包类型是jar：

  <packaging>jar</packaging>
  

• 在azure-functions-module的依赖中，正确引入dependency-module，并且不要设置scope为provided或test（默认compile就好，确保编译、运行时都能访问）：

  <dependency>
      <groupId>你的父模块groupId</groupId>
      <artifactId>dependency-module</artifactId>
      <version>${project.version}</version>
  </dependency>
  

2. 强制Azure插件包含本地依赖 #

关键一步：在azure-functions-module的azure-functions-maven-plugin配置里，添加<includeDependencies>true</includeDependencies>，让插件明确打包所有依赖（包括本地子模块）。完整插件配置示例：

<plugin>
    <groupId>com.microsoft.azure</groupId>
    <artifactId>azure-functions-maven-plugin</artifactId>
    <version>1.22.0</version> <!-- 建议用最新稳定版 -->
    <configuration>
        <appName>你的函数应用名</appName>
        <resourceGroup>你的资源组</resourceGroup>
        <region>你的区域</region>
        <runtime>
            <os>windows</os>
            <javaVersion>11</javaVersion> <!-- 匹配你的Java版本 -->
        </runtime>
        <includeDependencies>true</includeDependencies>
        <!-- 如果需要精准控制，还可以手动指定要包含的依赖 -->
        <!-- <dependencies>
            <dependency>
                <groupId>你的父模块groupId</groupId>
                <artifactId>dependency-module</artifactId>
                <version>${project.version}</version>
            </dependency>
        </dependencies> -->
    </configuration>
    <executions>
        <execution>
            <id>package-functions</id>
            <goals>
                <goal>package</goal>
            </goals>
        </execution>
    </executions>
</plugin>

3. 正确执行Maven打包流程 #

不要直接单独打包azure-functions-module！先在父模块根目录执行：

mvn clean install

这会先把dependency-module安装到本地Maven仓库，然后再打包azure-functions-module，确保Azure插件能从本地仓库拿到依赖的jar包。

4. 清理本地运行时缓存（本地调试时） #

如果本地运行时还是找不到jar，可能是临时目录的缓存问题。删除%USERPROFILE%\AppData\Local\Temp下所有以azure-functions开头的文件夹，然后重新启动函数，插件会重新复制最新的依赖文件。

临时排查方案（不推荐长期使用） #

如果上面的步骤还是不行，可以尝试把依赖设为system范围（仅用于测试，不适合团队协作）：

<dependency>
    <groupId>你的父模块groupId</groupId>
    <artifactId>dependency-module</artifactId>
    <version>${project.version}</version>
    <scope>system</scope>
    <systemPath>${project.parent.basedir}/dependency-module/target/dependency-module-${project.version}.jar</systemPath>
</dependency>

同时在Azure插件里添加<includeSystemScope>true</includeSystemScope>，确保系统依赖被包含到部署包中。

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