Excel插件异步网页抓取问题：程序提前退出如何解决

这个问题我之前做Excel插件异步操作时也碰到过，本质是对异步方法的调用逻辑和不同环境下的线程模型理解不到位，我来给你拆解一下解决方案：

一、先搞懂控制台测试时的问题根源 #

你当前的Main方法调用了async void的GetWebPage方法，async void这种写法一般只用于UI事件处理（比如按钮点击），在控制台程序里，主线程执行完Main方法后不会等待async void里的异步任务完成，直接就退出了，所以你加Console.ReadLine()相当于强行阻塞主线程，让异步任务有时间跑完，但这只是临时的测试手段，完全不适用于Excel插件场景。

控制台测试的正确写法（用于验证逻辑） #

把async void改成async Task，同时把Main改成async Task Main()（C# 7.1及以上版本支持），这样主线程会自动等待异步任务完成：

static async Task Main() { 
    await GetWebPage(new Uri("http://www.google.com")); 
}
static async Task GetWebPage(Uri URI) {
    string html = await HttpGetAsync(URI);
    Console.WriteLine(html);
}
static async Task<string> HttpGetAsync(Uri URI) {
    try {
        // 重要提醒：HttpClient不要每次新建，复用一个实例避免连接池耗尽
        using HttpClient hc = new HttpClient();
        using Stream vs = await hc.GetStreamAsync(URI);
        using StreamReader am = new StreamReader(vs);
        return await am.ReadToEndAsync();
    } catch (WebException ex) {
        switch (ex.Status) {
            case WebExceptionStatus.NameResolutionFailure:
                Console.WriteLine("domain_not_found");
                break;
            // 补充其他异常处理逻辑
        }
    }
    return "";
}

二、Excel插件中的核心解决方案（重点） #

你的最终需求是做Excel插件，Excel是单线程UI程序，绝对不能用阻塞方式（比如Wait()/Result），否则会直接冻结Excel界面，得结合Excel的UI线程模型来处理异步操作：

1. 按钮触发的异步操作（比如插件面板的下载按钮） #

如果是通过按钮触发下载，用async void作为事件处理方法没问题，但要在异步逻辑里避免阻塞，同时确保更新Excel单元格时在UI线程：

// 假设这是插件面板按钮的点击事件
public async void DownloadHtmlBtn_Click(object sender, EventArgs e)
{
    // 从A1单元格读取目标URL
    var urlValue = Globals.ThisAddIn.Application.Range["A1"].Value;
    if (urlValue == null || !Uri.TryCreate(urlValue.ToString(), UriKind.Absolute, out var targetUri))
    {
        MessageBox.Show("请在A1单元格输入有效的URL");
        return;
    }

    // 用Task.Run把HTTP请求放到后台线程，不阻塞Excel主线程
    var htmlContent = await Task.Run(() => HttpGetAsync(targetUri));

    // await会自动切回Excel的UI线程，直接更新单元格即可
    Globals.ThisAddIn.Application.Range["B1"].Value = htmlContent;
}

// 全局复用HttpClient，避免每次创建实例
private static readonly HttpClient _globalHttpClient = new HttpClient();

static async Task<string> HttpGetAsync(Uri uri) {
    try {
        using Stream responseStream = await _globalHttpClient.GetStreamAsync(uri);
        using StreamReader reader = new StreamReader(responseStream);
        return await reader.ReadToEndAsync();
    } catch (WebException ex) {
        switch (ex.Status) {
            case WebExceptionStatus.NameResolutionFailure:
                return "domain_not_found";
            default:
                return $"请求出错：{ex.Message}";
        }
    }
}

2. 自定义异步函数（UDF）=downloadHtml(A1) #

如果要实现类似公式的异步UDF，Excel原生支持异步UDF（需要对应插件框架支持，比如VSTO、Excel-DNA），写法如下：

// 标记为Excel自定义函数，Name对应公式名
[ExcelFunction(Name = "downloadHtml", Description = "抓取指定URL的HTML内容")]
public static async Task<string> DownloadHtml(string url)
{
    if (!Uri.TryCreate(url, UriKind.Absolute, out var targetUri))
    {
        return "错误：无效的URL格式";
    }

    return await HttpGetAsync(targetUri);
}

// 复用全局HttpClient
private static readonly HttpClient _globalHttpClient = new HttpClient();

static async Task<string> HttpGetAsync(Uri uri) {
    // 同上面的实现逻辑
}

注意：不同插件框架的异步UDF配置略有差异，比如Excel-DNA需要额外启用异步支持，VSTO则需要确保函数被正确注册为异步UDF。

关键注意事项 #

• 不要滥用async void：除了UI事件处理，其他场景一律用async Task，这样可以跟踪任务状态、捕获异常。
• 复用HttpClient：每次新建HttpClient会导致TCP连接无法及时释放，耗尽系统连接池，全局复用一个实例是最佳实践。
• Excel线程安全：所有操作Excel对象的代码必须在Excel的UI线程执行，await会自动捕获上下文（在VSTO等框架中），如果是手动切换线程，要用Globals.ThisAddIn.Application.Invoke方法。

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