C#路由中Base64编解码异常及Url.Action用法技术问询

核心问题 #

需要将含任意特殊字符的原始数据编解码后放入ASP.NET Core路由中，当前手动Base64编解码方案触发System.FormatException: The input is not a valid Base-64 string异常；尝试用Url.Action生成URL时，因硬编码路由前缀导致斜杠被转义，需解决这两个问题。

具体场景与问题 #

1. REST API端点路由定义：

   [Route("/ipaddress/pivotSearch/{key}/{value}/{incomingPage?}")]
   public async Task<IActionResult> pivotSearch(string key, string value, int page = 1){}
   

2. 直接传Base64会因/等字符干扰路由，因此先Base64编码再用Uri.EscapeDataString转义，但解码时出错。
3. 基于StackOverflow实现的编解码扩展方法存在逻辑缺陷：

   public static string SmartEncode(this string value)
   {
       string convertToBase64String = @Convert.ToBase64String(@Encoding.UTF8.GetBytes(value));
       return Uri.EscapeDataString(convertToBase64String);
   }
   
   public static string SmartDecode(this string value)
   {
       try
       {
           Log.Information($"Initial String To Decode: {value}");
           var decodeUrlString = Uri.UnescapeDataString(value.Trim()); ;
   
           Log.Information($"UrlDecode String: {decodeUrlString}");
           Log.Information($"UrlDecode String: #{decodeUrlString.Length}");
   
           return Encoding.UTF8.GetString(Convert.FromBase64String(decodeUrlString.Trim() + "="));
       }
       catch (Exception)
       {
           return Encoding.UTF8.GetString(Convert.FromBase64String(value.Trim()));
       }
   }
   

4. 部分验证有效的Base64字符串（如PGh0dHBzOi8vY3NlLmVuZ2luLnVtaWNoLmVkdS8/cD0xNzc2PjsgcmVsPXNob3J0bGluaw==）解码时触发异常。
5. 视图中调用编解码的方式：

   <a href="/ipaddress/pivotSearch/@PivotSearchKeyEnum.BANNER_VALUE.ToString()/@content.SmartEncode()/1" target="_blank"> TEST </a>
   

6. 部分内容（如1B7AE3AAF003CA8A23ACBA351CBA8084A7712F3B）无法成功完成编解码流程。

问题分析 #

1. 手动编解码逻辑错误：SmartDecode中硬加单个=补位不符合Base64规则（Base64长度需为4的倍数，补位数量需按模4结果计算）；同时Uri.EscapeDataString转义后的字符，在路由接收时会被自动解码，导致解码时重复处理损坏Base64字符串。
2. Url.Action使用错误：硬编码路由前缀会被Url.Action识别为参数的一部分，从而对斜杠进行转义，导致路由无效。

解决方案 #

方案一：优先使用内置Url.Action生成URL（推荐） #

ASP.NET Core的Url.Action会自动处理参数编码与路由拼接，完全无需手动编解码：

1. 优化Controller路由配置（可选，让结构更清晰）：

   [Route("ipaddress")] // 将前缀提取到Controller级别
   public class PivotSearchController : Controller
   {
       [Route("pivotSearch/{key}/{value}/{incomingPage?}")]
       public async Task<IActionResult> PivotSearch(string key, string value, int page = 1)
       {
           // 直接使用value即可，框架已自动完成解码
           // 业务逻辑代码
       }
   }
   

2. 视图中正确调用Url.Action：

   <a href="@Url.Action("PivotSearch", "PivotSearch", new {
       key = @PivotSearchKeyEnum.BANNER_VALUE.ToString(),
       value = @content,
       incomingPage = 1
   })" target="_blank">
       @System.Globalization.CultureInfo.CurrentCulture.TextInfo.ToTitleCase(content.Trim().ToLower()).Truncate(70)
   </a>
   

   • 注意：Url.Action的第二个参数是Controller名称，必须去掉类名末尾的Controller后缀（如PivotSearchController对应"PivotSearch"）。

方案二：修复手动编解码逻辑（仅在必须时使用） #

如果因特殊需求必须手动编解码，需修正扩展方法的逻辑：

public static string SmartEncode(this string value)
{
    byte[] bytes = Encoding.UTF8.GetBytes(value);
    string base64 = Convert.ToBase64String(bytes);
    // 替换Base64中路由敏感的字符，避免干扰路由解析
    return base64.Replace('+', '-').Replace('/', '_').TrimEnd('=');
}

public static string SmartDecode(this string value)
{
    try
    {
        // 还原替换的字符
        string base64 = value.Replace('-', '+').Replace('_', '/');
        // 按Base64规则正确补位：长度需为4的倍数
        int padding = 4 - (base64.Length % 4);
        if (padding != 4)
        {
            base64 += new string('=', padding);
        }
        byte[] bytes = Convert.FromBase64String(base64);
        return Encoding.UTF8.GetString(bytes);
    }
    catch (Exception ex)
    {
        Log.Error(ex, "解码失败：{Value}", value);
        return string.Empty; // 或根据业务需求返回默认值
    }
}

调用时需在Controller中手动解码：

public async Task<IActionResult> PivotSearch(string key, string value, int page = 1)
{
    string decodedValue = value.SmartDecode();
    // 业务逻辑代码
}

经验总结 #

• 优先使用框架内置的Url.Action生成URL，避免手动编解码带来的错误与复杂度。
• 使用Url.Action时，Controller参数必须省略类名的Controller后缀。
• 不要硬编码路由前缀，应通过Controller的[Route]属性统一配置，让Url.Action自动拼接完整路由。

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