萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> ASP.NET 程式設計

ASP.NET WebRequest 跨域訪問完整實作:GET/POST、編碼處理、超時控制與 JSONP 跨域方案

跨域訪問的必要性

瀏覽器同源策略限制 JavaScript 跨域請求,但**伺服器端程式碼不受此限制**。ASP.NET 透過 `WebRequest`/`HttpClient` 可直接呼叫外部 API、抓取網頁內容、對接舊系統 (ASP/PHP/JSP) 等。

通用 HttpHelper 類別實作


using System;
using System.IO;
using System.Net;
using System.Text;
using System.Configuration;

public static class HttpHelper
{
    private const int DefaultTimeout = 100000; // 100 秒
    private static readonly Encoding DefaultEncoding = Encoding.GetEncoding("GB2312"); // 繁體環境常用 Big5

    /// 
    /// POST 請求
    /// 
    public static string Post(string url, string postData, Encoding encoding = null, int timeout = DefaultTimeout)
    {
        encoding ??= DefaultEncoding;
        byte[] data = encoding.GetBytes(postData ?? "");

        var request = (HttpWebRequest)WebRequest.Create(url);
        request.Method = "POST";
        request.ContentType = "application/x-www-form-urlencoded";
        request.Timeout = timeout;
        request.ContentLength = data.Length;

        using (var stream = request.GetRequestStream())
            stream.Write(data, 0, data.Length);

        return GetResponseString(request, encoding);
    }

    /// 
    /// GET 請求
    /// 
    public static string Get(string url, string queryString = "", Encoding encoding = null, int timeout = DefaultTimeout)
    {
        encoding ??= DefaultEncoding;
        string fullUrl = string.IsNullOrEmpty(queryString) ? url : $"{url}?{queryString}";

        var request = (HttpWebRequest)WebRequest.Create(fullUrl);
        request.Method = "GET";
        request.ContentType = "application/x-www-form-urlencoded";
        request.Timeout = timeout;

        return GetResponseString(request, encoding);
    }

    /// 
    /// 統一處理回應
    /// 
    private static string GetResponseString(HttpWebRequest request, Encoding encoding)
    {
        try
        {
            using (var response = (HttpWebResponse)request.GetResponse())
            using (var stream = response.GetResponseStream())
            using (var reader = new StreamReader(stream, encoding))
            {
                return reader.ReadToEnd();
            }
        }
        catch (WebException ex)
        {
            // 讀取錯誤回應內容
            if (ex.Response != null)
            {
                using (var stream = ex.Response.GetResponseStream())
                using (var reader = new StreamReader(stream, encoding))
                {
                    return reader.ReadToEnd();
                }
            }
            throw; // 或回傳錯誤標記
        }
    }

    /// 
    /// 解析 URL 並自動判斷 GET/POST
    /// 
    public static string AutoRequest(string url, EnumMethod method = EnumMethod.GET)
    {
        var uri = new Uri(url);
        string path = $"https://{uri.Authority}{uri.AbsolutePath}";
        string query = uri.Query.TrimStart('?');
        return method == EnumMethod.POST ? Post(path, query) : Get(path, query);
    }
}

public enum EnumMethod { GET, POST }

關鍵技術點深度解析

1. 編碼處理:GB2312 vs UTF-8 vs Big5

  • **舊系統/中文網站**:常用 `GB2312` (簡體) 或 `Big5` (繁體)
  • **現代 API**:標準 `UTF-8`
  • **最佳實踐**:從 `response.CharacterSet` 或 `Content-Type` 標頭動態判斷,或嘗試多種編碼

// 動態編碼偵測
Encoding GetResponseEncoding(HttpWebResponse response)
{
    string charset = response.CharacterSet;
    if (!string.IsNullOrEmpty(charset))
    {
        try { return Encoding.GetEncoding(charset); } catch { }
    }
    // 從 Content-Type 解析
    string contentType = response.ContentType;
    if (contentType.Contains("charset="))
    {
        string cs = contentType.Split("charset=")[1].Split(';')[0].Trim();
        try { return Encoding.GetEncoding(cs); } catch { }
    }
    return Encoding.UTF8; // 預設
}

2. 超時控制三層防護


request.Timeout = 30000;           // 1. 整體請求超時 (連線+傳輸)
request.ReadWriteTimeout = 30000;  // 2. 讀寫流超時 (需轉型 HttpWebRequest)
request.ContinueTimeout = 5000;    // 3. 100-Continue 等待超時

3. 協定支援:Keep-Alive、壓縮、Cookie


request.KeepAlive = true;                    // 連線重用
request.AutomaticDecompression = DecompressionMethods.GZip | DecompressionMethods.Deflate; // 自動解壓
request.CookieContainer = new CookieContainer(); // 支援 Cookie 會話
// request.UserAgent = "Mozilla/5.0...";      // 模擬瀏覽器

4. SSL/TLS 憑證驗證 (開發/測試環境)


// 忽略憑證錯誤 (僅限開發/測試,生產環境嚴禁)
ServicePointManager.ServerCertificateValidationCallback = (s, cert, chain, errors) => true;
// 或指定安全協定
ServicePointManager.SecurityProtocol = SecurityProtocolType.Tls12 | SecurityProtocolType.Tls11 | SecurityProtocolType.Tls;

JSONP 跨域方案:前端視角

當**必須**在瀏覽器端直接呼叫跨域 API 時,JSONP 是傳統解法 (現代用 CORS)。

前端 jQuery 呼叫


$.ajax({
    type: "GET",
    url: "https://api.example.com/data",
    dataType: "jsonp",              // 關鍵:啟用 JSONP
    jsonp: "callback",              // 參數名 (預設 callback)
    jsonpCallback: "handleData",    // 回調函數名 (可選,自動產生)
    success: function(json) {
        console.log("資料:", json);
    },
    error: function() {
        alert("請求失敗");
    }
});

// 全域回調函數 (若指定 jsonpCallback)
function handleData(data) {
    console.log("JSONP 回調:", data);
}

後端 ASP.NET 實作 JSONP 端點


// Handler.ashx 或 Controller Action
public void ProcessRequest(HttpContext context)
{
    string callback = context.Request["callback"] ?? context.Request["jsonp"];
    var data = new { Name = "張三", Age = 25, Time = DateTime.Now };
    string json = Newtonsoft.Json.JsonConvert.SerializeObject(data);
    
    context.Response.ContentType = "application/javascript"; // JS 內容類型
    
    if (!string.IsNullOrEmpty(callback))
    {
        // 防 XSS:驗證 callback 只包含合法字元
        if (System.Text.RegularExpressions.Regex.IsMatch(callback, @"^[\w\.$\[\]]+$"))
            context.Response.Write($"{callback}({json});");
        else
            context.Response.Write($"/* 非法回調名 */ {json};");
    }
    else
    {
        context.Response.Write(json); // 純 JSON
    }
}

現代替代方案:HttpClient + CORS

ASP.NET Core / .NET 5+ 使用 HttpClient (推薦)


private static readonly HttpClient _httpClient = new HttpClient 
{ 
    Timeout = TimeSpan.FromSeconds(30) 
};

public static async Task PostAsync(string url, object data)
{
    var json = JsonConvert.SerializeObject(data);
    var content = new StringContent(json, Encoding.UTF8, "application/json");
    var response = await _httpClient.PostAsync(url, content);
    response.EnsureSuccessStatusCode();
    return await response.Content.ReadAsStringAsync();
}

CORS 跨域資源共享 (現代標準)

**伺服器端配置 (ASP.NET Core)**:


// Startup.cs
services.AddCors(options =>
{
    options.AddPolicy("AllowSpecificOrigin", builder =>
        builder.WithOrigins("https://www.myapp.com")
               .AllowAnyHeader()
               .AllowAnyMethod()
               .AllowCredentials()); // 允許 Cookie
});

app.UseCors("AllowSpecificOrigin");

**優點**:標準化、支援所有 HTTP 方法、支援自訂標頭、支援憑證、瀏覽器原生支援、無需 JSONP 繞彎。

常見問題排查表

問題可能原因解決方案
中文亂碼編碼不匹配動態偵測 encoding、強制 UTF-8、檢查 BOM
The request was aborted: Could not create SSL/TLS secure channelTLS 版本不支援設定 `SecurityProtocolType.Tls12`
403 ForbiddenUser-Agent、Referer、Cookie 缺失模擬瀏覽器標頭、攜帶 CookieContainer
連線逾時防火牆、Proxy、DNS、對方封鎖設定 Proxy、檢查網路、調整 Timeout
大檔案下載 OOM一次性 ReadToEnd串流處理 `CopyToAsync`、分塊讀取

總結

ASP.NET 伺服器端跨域訪問核心在於 `HttpWebRequest`/`HttpClient` 不受瀏覽器同源策略限制。掌握 **編碼自動偵測**、**超時三層設定**、**壓縮與 Keep-Alive**、**SSL 處理**、**錯誤回應讀取** 等關鍵技巧,能建立健壯的整合介面。現代架構下,**前端跨域請改用 CORS**,**後端整合優先用 HttpClient + Polly 重試熔斷**,JSONP 僅作為舊瀏覽器相容備案。

copyright © 萬盛學電腦網 all rights reserved