C#使用Basic认证获取远程图片及代码实现

核心实现原理

获取受认证保护的图片主要依赖HTTP的Basic Authentication机制。客户端需要在请求头中包含经过Base64编码的用户名和密码。在C# .NET Framework环境中，System.Net.HttpWebRequest是发起此类请求的标准类，而CredentialCache则用于管理身份验证凭据。

完整代码实现

以下代码基于ASP.NET Page生命周期编写，演示了如何构建请求、添加认证信息、发送POST请求（注意：虽然获取图片通常用GET，但原逻辑使用了POST，此处保留原意并优化结构）并将结果返回给前端。

using System;
using System.Collections.Generic;
using System.Drawing;
using System.IO;
using System.Linq;
using System.Net;
using System.Text;
using System.Web;
using System.Web.UI;
using System.Web.UI.WebControls;

namespace Web.App_Code
{
    public partial class GetFlexImage : System.Web.UI.Page
    {
        // 假设已集成log4net日志记录器
        public static readonly log4net.ILog log = log4net.LogManager.GetLogger(System.Reflection.MethodBase.GetCurrentMethod().DeclaringType);

        protected void Page_Load(object sender, EventArgs e)
        {
            // 1. 参数校验
            if (Request["IMG"] == null || string.IsNullOrEmpty(Request["IMG"]))
            {
                return;
            }

            try
            {
                // 2. 处理URL，防止特殊字符干扰
                string url = Request["IMG"].Replace("%", "%25");
                Uri uri = new Uri(url);

                // 3. 配置认证凭据
                CredentialCache cc = new CredentialCache();
                // 注意：此处用户名密码硬编码仅为示例，生产环境应使用配置文件或密钥管理服务
                cc.Add(uri, "Basic", new NetworkCredential("epapi", "密码"));

                // 4. 创建并配置请求
                HttpWebRequest WRequest = (HttpWebRequest)HttpWebRequest.Create(uri);
                WRequest.Credentials = cc;
                WRequest.PreAuthenticate = true;
                WRequest.Method = "POST"; // 根据源文档保留POST方式
                WRequest.AllowWriteStreamBuffering = false;
                WRequest.SendChunked = false;
                WRequest.KeepAlive = true;
                WRequest.ContentLength = 0;
                WRequest.Timeout = 30000;

                // 额外添加Header以确保某些严格服务器的兼容性（可选）
                WRequest.Headers.Add("Authorization", "Basic " + Convert.ToBase64String(new ASCIIEncoding().GetBytes("epapi:epapiadmin")));

                HttpWebResponse response = null;

                // 5. 发送请求并获取响应
                try
                {
                    response = (HttpWebResponse)WRequest.GetResponse();
                }
                catch (WebException er)
                {
                    // 即使发生网络异常，有时Response仍可用以读取错误详情
                    response = (HttpWebResponse)er.Response;
                }

                if (response != null && response.StatusCode == HttpStatusCode.OK)
                {
                    // 6. 读取图片数据
                    Bitmap myImage = new Bitmap(response.GetResponseStream());
                    MemoryStream ms = new MemoryStream();

                    // 保存为GIF格式输出，可根据实际需求调整格式
                    myImage.Save(ms, System.Drawing.Imaging.ImageFormat.Gif);

                    // 7. 输出响应
                    Response.ClearContent();
                    Response.ContentType = "image/gif";
                    log.Debug("图片加载成功：" + Request["IMG"]);
                    Response.BinaryWrite(ms.ToArray());
                }
            }
            catch (Exception err)
            {
                log.Debug("图片加载异常：" + Server.HtmlDecode(Request["IMG"]) + " - " + err.Message);
            }
        }
    }
}

关键点说明

1. 凭据配置：代码中使用CredentialCache.Add指定了认证类型为"Basic"。同时手动在Headers中添加了Authorization字段，双重保险确保服务器能正确识别。
   
2. URL处理：原始URL中的百分号%需要被转义为%25，以避免在重新编码时导致URL解析错误。
   
3. 异常处理：捕获WebException是关键步骤，因为即使请求失败（如401 Unauthorized），er.Response对象可能仍然包含有用的状态信息，避免程序直接崩溃。
   
4. 资源释放：在生产环境中，应确保Bitmap、MemoryStream和HttpWebResponse在使用完毕后被正确dispose，以防止内存泄漏。上述简化代码中省略了using语句块以保持与原逻辑一致，建议在实际项目中加上。
   

排错指南

• 401 Unauthorized：检查用户名、密码是否正确，且账号是否拥有访问该图片资源的权限。确认服务器确实使用Basic认证而非Digest或其他形式。
  
• 无效的图片格式：如果服务器返回的不是标准图片流（如HTML错误页），使用new Bitmap()可能会抛出异常。建议在读取前检查response.ContentType。
  
• 编码问题：ASCIIEncoding仅支持ASCII字符，如果用户名或密码包含中文等非ASCII字符，应改用UTF8Encoding并进行相应的URL编码处理。
  

以上就是C#通过Basic认证获取远程图片的详细内容，更多关于C#网络编程的资料请关注本站其它相关文章！