PHP cURL导出SSRS CSV文件时字符编码异常的解决方案咨询

遇到这种SSRS导出CSV的编码问题真的挺闹心的，我之前也踩过类似的坑！浏览器手动下载正常，但cURL脚本就乱码，核心原因大多是SSRS的CSV导出默认编码和你脚本的编码处理不匹配，而且mb_detect_encoding有时候会“骗”你。

为什么浏览器正常，cURL不行？ #

浏览器会自动识别SSRS返回的编码（比如通过响应头的charset或者文件BOM），并自动做编码转换；但cURL只会原封不动返回字节流，你的脚本如果没匹配SSRS实际返回的编码，就会转码错误——比如你遇到的20–30%，正好是把UTF-16LE编码的en-dash（两个字节0x13 0x20）误当成Windows-1252解码的结果，这说明SSRS可能默认给你返回了UTF-16LE格式的CSV，而你的编码检测逻辑把它识别成了单字节编码。

具体解决方案 #

1. 先确认SSRS实际返回的编码

先在cURL请求后加一行代码，打印响应的Content-Type头，明确SSRS返回的编码：

$ch = curl_init("http://qreports-ssrs-site.com/ReportServer?%2fMyReport&rs:Format=CSV");
// ... 你的cURL配置 ...
$response = curl_exec($ch);
// 新增：打印响应的Content-Type，查看charset
$contentType = curl_getinfo($ch, CURLINFO_CONTENT_TYPE);
var_dump($contentType); // 比如会输出 "text/csv; charset=utf-16le"
curl_close($ch);

如果输出里包含charset=utf-16le，那就是核心问题所在了。

2. 直接处理SSRS默认的UTF-16LE编码

绝大多数SSRS实例导出CSV时，默认会返回带BOM的UTF-16LE编码（为了兼容Excel），你可以直接针对这个编码做转换，而不是依赖自动检测：

$ch = curl_init("http://qreports-ssrs-site.com/ReportServer?%2fMyReport&rs:Format=CSV");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 1500,
    CURLOPT_HTTPAUTH => CURLAUTH_NTLM,
    CURLOPT_USERPWD => "DOMAIN\\user:pass",
    CURLOPT_HTTPHEADER => ["Accept: text/csv"],
]);
$response = curl_exec($ch);
curl_close($ch);

// 优先处理SSRS最常见的UTF-16LE编码
$fixedResponse = $response;
// 检查UTF-16LE的BOM（FF FE）
if (substr($response, 0, 2) === "\xFF\xFE") {
    // 直接转成UTF-8，mb_convert_encoding会自动忽略BOM
    $fixedResponse = mb_convert_encoding($response, 'UTF-8', 'UTF-16LE');
} else {
    //  fallback到手动检测（优先单字节编码，因为UTF-16已经被处理）
    $encoding = mb_detect_encoding($response, ['Windows-1252', 'ISO-8859-1', 'UTF-8'], true);
    if ($encoding && $encoding !== 'UTF-8') {
        $fixedResponse = mb_convert_encoding($response, 'UTF-8', $encoding);
    }
}

// 为了兼容Excel打开UTF-8 CSV，添加UTF-8 BOM
if (substr($fixedResponse, 0, 3) !== "\xEF\xBB\xBF") {
    $fixedResponse = "\xEF\xBB\xBF" . $fixedResponse;
}

file_put_contents('report.csv', $fixedResponse);

3. 可选：强制SSRS返回UTF-8编码

如果你的SSRS实例支持，可以在请求头里明确要求UTF-8编码，减少转换步骤：

CURLOPT_HTTPHEADER => [
    "Accept: text/csv",
    "Accept-Charset: UTF-8"
],

不过注意：部分旧版SSRS可能不支持Accept-Charset协商，这时候还是用方案2更稳妥。

额外排查技巧 #

用Notepad++打开浏览器手动下载的CSV文件，右下角会显示文件的实际编码（比如“UTF-16LE”），再对比cURL直接返回的原始文件（跳过你的编码转换逻辑，直接file_put_contents('raw.csv', $response)）的编码，就能100%确认SSRS返回的编码，避免mb_detect_encoding的误判。

内容来源于stack exchange