Spring Cloud Azure Function部署后主类无法检测问题

问题根源 #

本地运行正常，但部署到Azure后出现主类找不到的错误，核心原因是：

• 本地运行依赖Jar包MANIFEST.MF中的Main-Class条目加载主类
• Azure Functions运行时必须通过MAIN_CLASS应用设置指定主类，不会读取Jar内的Main-Class配置

修复步骤 #

1. 启用Azure Functions Maven插件的MAIN_CLASS配置 #

在azure-functions-maven-plugin的appSettings中取消MAIN_CLASS配置的注释，确保值与主类全路径一致：

<appSettings>
    <property>
        <name>FUNCTIONS_EXTENSION_VERSION</name>
        <value>~4</value>
    </property>
    <property>
        <name>MAIN_CLASS</name>
        <value>com.azlearning.functionapp.AzEmailSenderFunctionApplication</value>
    </property>
</appSettings>

2. 启用并配置Spring Boot Maven插件 #

之前的配置注释掉了Spring Boot Maven插件，需要重新启用它，确保正确打包生成包含主类信息的Jar包，同时结合spring-boot-thin-layout优化Azure部署包体积：

<plugin>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-maven-plugin</artifactId>
    <configuration>
        <mainClass>com.azlearning.functionapp.AzEmailSenderFunctionApplication</mainClass>
        <excludes>
            <exclude>
                <groupId>org.projectlombok</groupId>
                <artifactId>lombok</artifactId>
            </exclude>
        </excludes>
    </configuration>
    <dependencies>
        <dependency>
            <groupId>org.springframework.boot.experimental</groupId>
            <artifactId>spring-boot-thin-layout</artifactId>
            <version>${spring-boot-thin-layout.version}</version>
        </dependency>
    </dependencies>
    <executions>
        <execution>
            <goals>
                <goal>repackage</goal>
            </goals>
        </execution>
    </executions>
</plugin>

注：添加repackage目标确保生成可执行Jar；thin-layout会让部署包仅包含依赖描述，Azure运行时自动下载依赖，大幅减少包体积。

3. 重新打包并部署 #

执行Maven命令重新打包：

mvn clean package

再通过IntelliJ或Maven插件重新部署到Azure Functions。

4. 验证Azure应用设置 #

部署完成后，登录Azure门户进入你的Function App：

• 打开配置 -> 应用程序设置
• 确认MAIN_CLASS已存在，且值正确指向主类全路径

完整修改后的POM关键片段 #

<build>
    <plugins>
        <!-- 其他插件保持不变 -->
        <plugin>
            <groupId>com.microsoft.azure</groupId>
            <artifactId>azure-functions-maven-plugin</artifactId>
            <version>${azure.functions.maven.plugin.version}</version>
            <configuration>
                <!-- 其他配置保持不变 -->
                <appSettings>
                    <property>
                        <name>FUNCTIONS_EXTENSION_VERSION</name>
                        <value>~4</value>
                    </property>
                    <property>
                        <name>MAIN_CLASS</name>
                        <value>com.azlearning.functionapp.AzEmailSenderFunctionApplication</value>
                    </property>
                </appSettings>
            </configuration>
            <executions>
                <execution>
                    <id>package-functions</id>
                    <goals>
                        <goal>package</goal>
                    </goals>
                </execution>
            </executions>
        </plugin>

        <plugin>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-maven-plugin</artifactId>
            <configuration>
                <mainClass>com.azlearning.functionapp.AzEmailSenderFunctionApplication</mainClass>
                <excludes>
                    <exclude>
                        <groupId>org.projectlombok</groupId>
                        <artifactId>lombok</artifactId>
                    </exclude>
                </excludes>
            </configuration>
            <dependencies>
                <dependency>
                    <groupId>org.springframework.boot.experimental</groupId>
                    <artifactId>spring-boot-thin-layout</artifactId>
                    <version>${spring-boot-thin-layout.version}</version>
                </dependency>
            </dependencies>
            <executions>
                <execution>
                    <goals>
                        <goal>repackage</goal>
                    </goals>
                </execution>
            </executions>
        </plugin>
    </plugins>
</build>

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