Spring Cloud Function + AWS Adapter无法识别MANIFEST.MF主类

可能的遗漏点及解决方法 #

• 确认Shaded JAR的MANIFEST.MF有效性
  本地解压打包后的Shaded JAR，直接查看META-INF/MANIFEST.MF文件，确认Main-Class和Start-Class确实为mypackage.Main，且包名、类名大小写与实际代码完全一致。maven-shaded-plugin在合并多个MANIFEST文件时可能覆盖自定义属性，需确保插件配置中通过transformer明确锁定这两个属性：

  <plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-shaded-plugin</artifactId>
    <version>3.4.1</version>
    <executions>
      <execution>
        <phase>package</phase>
        <goals>
          <goal>shade</goal>
        </goals>
        <configuration>
          <transformers>
            <transformer implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer">
              <mainClass>mypackage.Main</mainClass>
              <manifestEntries>
                <Start-Class>mypackage.Main</Start-Class>
              </manifestEntries>
            </transformer>
          </transformers>
        </configuration>
      </execution>
    </executions>
  </plugin>
  

• 检查AWS Lambda运行时配置
  AWS Lambda部署Spring Cloud Function依赖spring-cloud-function-adapter-aws适配器，需确保：

  1. 项目依赖中包含适配包（版本与Spring Cloud Function匹配）
  2. Lambda的Handler配置为org.springframework.cloud.function.adapter.aws.FunctionInvoker::handleRequest，而非直接指定你的主类——适配器会负责加载Spring上下文并定位主类。

• 验证主类的Spring Boot规范
  即便未使用Spring Boot Starter Parent，主类仍需符合Spring Boot应用标准：带有@SpringBootApplication注解，且包含标准main方法：

  package mypackage;
  
  import org.springframework.boot.SpringApplication;
  import org.springframework.boot.autoconfigure.SpringBootApplication;
  
  @SpringBootApplication
  public class Main {
      public static void main(String[] args) {
          SpringApplication.run(Main.class, args);
      }
  }
  

  缺少注解或main方法会导致Spring Cloud Function无法初始化上下文。

• 确认部署包结构完整性
  确保上传的Shaded JAR包含所有依赖，是完整的可执行包。避免上传未Shaded的JAR，因依赖缺失会间接引发主类加载失败。

• 强制指定MAIN_CLASS环境变量
  在AWS Lambda的环境变量中添加MAIN_CLASS=mypackage.Main，强制绕过MANIFEST读取逻辑，验证是否为MANIFEST属性未被正确识别的问题。

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