Azure App Service中Spring Boot @Async注解失效致大文件上传超时

核心原因：手动实例化Bean导致@Async代理失效 #

你在FileService.uploadFile()中直接通过new FileServiceAsyncImpl()创建实例，这个对象不属于Spring容器管理，Spring的AOP代理无法对其生效，因此@Async注解会被忽略。本地测试可能存在误判（比如上传速度快导致看起来异步），但本质上这种写法在任何环境下都不应该生效。

修复步骤 #

1. 将异步服务类交给Spring容器管理 #

给FileServiceAsyncImpl添加@Service或@Component注解，让Spring初始化并管理这个Bean：

@Service
public class FileServiceAsyncImpl {
    @Async
    public void uploadAsync(BlobClient blob, BlobParallelUploadOptions parallelUploadOptions, Duration timeout) {
        // 原有上传逻辑
        Response<BlockBlobItem> response = blob.uploadWithResponse(parallelUploadOptions, timeout, null);
        System.out.println("Upload Status: "+response.getStatusCode());
        System.out.println(response.getValue().toString());
    }
}

2. 通过依赖注入调用异步方法 #

在FileService中注入Spring管理的FileServiceAsyncImpl实例，替换手动new的代码：

@Service
public class FileService {
    // 注入容器管理的异步服务Bean
    @Autowired
    private FileServiceAsyncImpl fileServiceAsync;

    public FileDTO uploadFile(FileDTO fileDTO) {
        // 原有Blob客户端初始化逻辑...
        
        // 调用容器Bean的异步方法
        fileServiceAsync.uploadAsync(blob, parallelUploadOptions, timeout);
        
        return fileDTO;
    }
}

3. 配置自定义线程池（可选但推荐） #

默认的SimpleAsyncTaskExecutor不重用线程，在Azure环境下可能受资源限制导致异常。建议在Config类中配置自定义线程池：

@Configuration
@EnableAsync
public class Config {
    @Bean(name = "fileUploadExecutor")
    public TaskExecutor fileUploadTaskExecutor() {
        ThreadPoolTaskExecutor executor = new ThreadPoolTaskExecutor();
        executor.setCorePoolSize(4);
        executor.setMaxPoolSize(8);
        executor.setQueueCapacity(16);
        executor.setThreadNamePrefix("FileUpload-");
        executor.setWaitForTasksToCompleteOnShutdown(true);
        executor.initialize();
        return executor;
    }
}

然后在@Async注解中指定线程池：

@Async("fileUploadExecutor")
public void uploadAsync(...) {
    // 逻辑不变
}

额外检查点 #

• 确保@SpringBootApplication的组件扫描范围覆盖FileServiceAsyncImpl所在的包，避免Spring无法发现该Bean。
• 检查Azure App Service的Java版本与本地一致，版本差异可能导致AOP代理逻辑异常。
• 查看应用日志，确认是否有ThreadPoolTaskExecutor初始化日志，或与AOP代理相关的错误信息。

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