Java Springboot Web框架迁移到函数计算

更新时间：2026-09-24

本文将介绍如何将Spring Boot应该迁移部署到函数计算。

环境准备

安装 OpenJDK 1.8.0 及以上运行环境，并确保已安装 Maven。

迁移应用

如果您还没有开通CFC服务，请参考函数计算开通；如果您已开通，则可以跳过该步骤。

创建一个spring boot项目
引入百度云函数计算SDK

在项目pom.xml中添加百度云原生函数计算CFC（2.1.0及以上版本）的依赖。

                XML
                
            

                <dependency>
    <groupId>com.baidu.cfc</groupId>
    <artifactId>cfc-java-core</artifactId>
    <version>2.1.1</version>
</dependency>
            

代码改造

在项目的根目录src/main/java的任意目录下新增一个执行方法入口，例如在src/main/java/tacos的目录下创建MyHandler类用于实现AbstractSpringBootHandler

                Java
                
            

                package tacos;
 
import com.baidubce.cfc.core.AbstractSpringBootHandler;
public class MyHandler extends AbstractSpringBootHandler{
 
    @Override
    public void startApp() {
        // 修改为springboot项目的入口主函数，例如: 入口为TacosCloudlication class下的main函数
        TacosCloudApplication.main(new String[]{""});
    }
}
            

添加mainClass类，如APP类(需要修改pom.xml设置为启动类)

                Java
                
                package tacos;
 
import com.baidubce.cfc.core.CfcClient;
 
public class App {
    public static void main(String[] args){
        CfcClient.main();
    }
}

Maven 编译并打包函数代码

如果完成上述对 Spring Boot 服务的改造工作，还需要对项目的打包构建进行调整，以满足 CFC 对函数代码包的要求。

要求	说明
主 JAR	打包上传的 ZIP 根目录只保留一个与 `mainClass` 对应的 JAR 包。
启动类	`mainClass` 对应的类必须用于启动 `CfcClient`。
依赖目录	所有依赖 JAR 必须随代码包一起上传，并放在 `lib/` 目录。
处理程序	函数中配置的 `Handler` 必须与代码中实现的处理类保持一致。

增加 plugin 配置

在 pom.xml 文件中添加 maven-dependency-plugin 和 maven-jar-plugin。前者用于将依赖复制到 ${project.build.directory}/lib 目录，后者用于构建可执行 JAR。请在 project 标签下增加如下配置：

                XML
                
            

                <build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-dependency-plugin</artifactId>
            <version>3.1.1</version>
            <executions>
                <execution>
                    <id>copy-dependencies</id>
                    <phase>package</phase>
                    <goals>
                        <goal>copy-dependencies</goal>
                    </goals>
                    <configuration>
                        <outputDirectory>${project.build.directory}/lib</outputDirectory>
                        <overWriteReleases>false</overWriteReleases>
                        <overWriteSnapshots>false</overWriteSnapshots>
                        <overWriteIfNewer>true</overWriteIfNewer>
                    </configuration>
                </execution>
            </executions>
        </plugin>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-jar-plugin</artifactId>
            <version>3.0.2</version>
            <configuration>
                <archive>
                    <manifest>
                        <addClasspath>true</addClasspath>
                        <classpathPrefix>lib/</classpathPrefix>
                        <mainClass>tacos.App</mainClass>
                    </manifest>
                </archive>
            </configuration>
        </plugin>
    </plugins>
</build>
            

参数	必填	说明
`outputDirectory`	是	将依赖复制到 `${project.build.directory}/lib` 目录。
`mainClass`	是	设置可执行 JAR 的启动类，本例为 `tacos.App`。
`classpathPrefix`	否	为依赖类路径添加 `lib/` 前缀。

发布打包

                Bash
                
                # 打包
mvn clean package
# zip 压缩
cd target && zip -r springboot.zip xxx-xxx.0.0.1-SNAPSHOT.jar lib/