Java与JS间%FF编码异常：URLEncoder与decodeURIComponent报错求助

原因分析 #

URLEncoder.encode 会将字符按指定字符集转成%XX形式的URL编码，但如果原内容包含不符合UTF-8规范的字节（比如%FF，属于单字节非ASCII字符，不符合UTF-8编码规则），decodeURIComponent 会因无法解析无效的UTF-8序列抛出URIError。

可行方案 #

方案1：改用Base64编码（推荐） #

Base64对任意字节序列都能安全编码解码，不会出现格式错误问题：

• JSP端：将文件内容转成Base64字符串输出

  // Java 8+ 自带Base64工具类
  String base64Content = Base64.getEncoder().encodeToString(fileContents.getBytes("UTF-8"));
  out.println(base64Content);
  

• JS端：用atob()解码Base64字符串

  const decodedContent = atob(result);
  // 若为二进制内容，可转成Blob处理
  // const blob = new Blob([new Uint8Array(atob(result).split('').map(c => c.charCodeAt(0)))]);
  

方案2：容错式URL解码 #

如果必须保留URL编码方式，可以实现一个容错的解码函数，跳过或替换无效的UTF-8序列：

function safeDecodeURIComponent(str) {
  try {
    return decodeURIComponent(str);
  } catch (e) {
    // 替换无效的%XX序列，这里用�替代，可按需调整
    return str.replace(/%[0-9A-F]{2}/gi, match => {
      try {
        return decodeURIComponent(match);
      } catch {
        return '\ufffd';
      }
    });
  }
}

// 使用方式
const decodedContent = safeDecodeURIComponent(result);

方案3：统一字符集并修正源内容 #

• 首先在JSP编码时明确指定UTF-8，避免平台默认字符集问题：

  String encodedContent = URLEncoder.encode(fileContents, "UTF-8");
  out.println(encodedContent);
  

• 检查源文件内容，确保是标准UTF-8编码，移除或转换不符合UTF-8的字节（比如%FF这类单字节非ASCII字符），这样decodeURIComponent就能正常解码。

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