本地正常的Java服务器部署Vercel后无法接收请求的问题求助

核心原因 #

Vercel的部署模型以Serverless函数为核心，不支持传统Java常驻型服务器（如Spring Boot内嵌Tomcat、独立Tomcat服务）的持续运行：

• Vercel会在请求触发时尝试启动服务，但Java应用启动耗时较长，容易触发平台超时限制；
• 平台默认会回收闲置的长进程，导致服务无法持续响应请求。
  除此之外，还有以下常见问题：

1. 端口硬编码：本地硬编码8080等端口，而Vercel会分配动态端口，服务无法绑定正确端口。
2. 数据库访问限制：本地MySQL仅允许本地连接，Vercel服务器无法访问；或是数据库防火墙未开放Vercel IP段，连接参数（如主机地址、密码）未通过环境变量正确配置。
3. 部署配置错误：未正确设置Vercel的构建/启动命令，导致Java项目未正确打包或启动失败。

解决步骤 #

1. 适配Vercel Serverless规范
   放弃传统常驻服务模式，改用Vercel支持的Java Serverless函数：

   • 按Vercel Java Runtime规范编写函数（可基于Vert.x、Spring Boot的Serverless适配方案），每个HTTP请求对应一个函数执行；
   • 在项目根目录创建vercel.json配置文件，指定函数运行时与路径，示例：

     {
       "functions": {
         "api/**/*.java": {
           "runtime": "@vercel/java@4.0.0"
         }
       }
     }
     

2. 修正端口配置
   在Java项目中读取Vercel提供的PORT环境变量，避免硬编码：

   • Spring Boot项目：在application.properties中设置server.port=${PORT:8080}，本地默认用8080，Vercel环境自动使用分配的端口。

3. 修复数据库连接

   • 将本地MySQL替换为云数据库（如阿里云RDS、AWS RDS），开启公网访问权限；
   • 在Vercel控制台的「环境变量」中配置数据库连接参数（DB_URL、DB_USERNAME、DB_PASSWORD），代码中通过环境变量读取这些值；
   • 配置数据库安全组，允许Vercel的IP段访问（可查询Vercel官方公布的IP范围）。

4. 调整部署命令
   在vercel.json中配置正确的构建与安装命令，以Spring Boot Maven项目为例：

   {
     "installCommand": "./mvnw install -DskipTests",
     "buildCommand": "./mvnw clean package"
   }
   

让服务正常接收各类请求的配置 #

1. 配置CORS
   在Java服务中添加CORS支持，允许来自前端域名、Postman的跨域请求：

   • Spring Boot项目可添加全局CORS配置：

     @Configuration
     public class CorsConfig {
         @Bean
         public CorsFilter corsFilter() {
             CorsConfiguration config = new CorsConfiguration();
             config.addAllowedOriginPattern("*");
             config.addAllowedMethod("*");
             config.addAllowedHeader("*");
             UrlBasedCorsConfigurationSource source = new UrlBasedCorsConfigurationSource();
             source.registerCorsConfiguration("/**", config);
             return new CorsFilter(source);
         }
     }
     

2. 确认请求路径
   Vercel Serverless函数的访问路径默认是/api/[函数文件名]，需调整前端、Postman的请求URL对应正确路径；若使用自定义域名，需在Vercel控制台完成域名绑定与解析。

3. 验证环境变量
   确保所有敏感配置（如数据库密码、密钥）都已在Vercel环境变量中正确配置，且代码中能正常读取。

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