由于個人在JMeter 3.0的實際應用中，腳本中的Test Plan/Sampler等元件命名都沒有使用中文，所以在之前介紹Dashboard Report特性的博客(原文戳這里))成文時，沒有提到關于中文的問題。之后有朋友反饋，Sampler名稱為中文時，生成的報告中展示為亂碼，自己測試，確實如此。
如圖，腳本包含兩個命名為中文的Sampler：
執(zhí)行測試后，生成的Dashboard Report圖表中文亂碼：
于是通過查看官方文檔和源碼，找到原因并進行了解決，原打算直接追加到之前那篇文章，但考慮到篇幅過長，于是決定新成一文，然后在之前的文章中補充鏈接。
二. 解決方案
先上解決方案：修改JMeter report模塊讀取數(shù)據(jù)源碼中的字符集設置為UTF-8，編譯后替換到 JMETER_HOME\lib\ext\ApacheJMeter_core.jar 內，這里會分享一個我處理好的一個jar包，但建議自己親自動手：
基礎方案
1、在官網(wǎng) 下載頁面 下載 apache-jmeter-3.0_src.zip
2、相關源碼位置：
apache-jmeter-3.0/src/core/org/apache/jmeter/report/core/CsvSampleReader.java
3、將 CsvSampleReader 的 CHARST 賦值為 UTF-8
private static final String CHARSET = StandardCharsets.UTF_8.displayName();
4、編譯該文件，用得到的 .class 文件替換 JMETER_HOME\lib\ext\ApacheJMeter_core.jar 內的原文件。當然也可以直接對源碼重新編譯打包，但會比較費時。
效果如圖：
推薦方案
關于設置字符編碼，一個更推薦的方案是設置默認字符編碼為UTF-8，同時支持.properties配置項。JMeter讀寫結果文件
(xml/csv)的字符編碼配置項是 ./bin/saveservice.properties 文件內的 _file_encoding ，由
org.apache.jmeter.save.SaveService.getFileEncoding(String dflt)
讀取，當沒有在配置相中指定時，將使用方法的入?yún)⒆鳛槟J編碼，這里我們傳入UFT-8作為默認格式，因此將基礎方案中的步驟3做如下變更：
private static final String CHARSET = SaveService.getFileEncoding(StandardCharsets.UTF_8.displayName());
編譯后替換即可。saveservice.properties文件的_file_encoding默認已配置為UTF-8，多數(shù)情況下，我們不需要修改。
文件分享
分享的文件和jar包是使用推薦方案進行處理?？梢匀∮胏lass文件自己替換進本地的ApacheJMeter_core.jar，也可以直接下載分享的jar包替換本地對應jar包。
· 單獨的CsvSampleReader.class文件： https://pan.baidu.com/s/1bo10QnX ，提取碼 ee68
·?處理完畢的ApacheJMeter_core.jar： https://pan.baidu.com/s/1mhKLwgw ，提取碼 id7h
注：github上可以看到jmeter的trunk分支已經(jīng)將dashboard report的默認字符編碼更改為UFT-8，本文的推薦方案即是官方更新中的實現(xiàn)方式。只是目前官方還沒有發(fā)布更新，所以自己動手。
三. 成因分析
Dashboard Report特性生成HTML圖表，使用JMeter記錄測試結果數(shù)據(jù)的文件 (命令行執(zhí)行時 -l
指定的文件，也可在圖形界面的監(jiān)聽器中指定，作為基礎知識不在這里展開) 作為數(shù)據(jù)源，Apache
FreeMarker作為模板引擎，默認的模板位于JMETER_HOME\bin\report-template。
·?查看官方說明，確認沒有關于HTML報告字符編碼的配置項。
·?查看數(shù)據(jù)源文件，確定文件格式為UTF-8，文件中的中文正常可讀，排除數(shù)據(jù)源存在問題的可能。
·?查看生成的結果文件，主要數(shù)據(jù)在 指定路徑/content/js/graph.js ，任選一個圖表數(shù)據(jù)，查看其標簽的值(“l(fā)abel”:” * “)，顯示為亂碼，排除js解析成亂碼的可能。
·?此時首先想到Java文件讀取過程問題，從官方發(fā)布的源碼包查看源碼 src/core/org/apache/jmeter/report/core/CsvSampleReader ，發(fā)現(xiàn)代碼中字符編碼指定為ISO8859-1:
package org.apache.jmeter.report.core;
//次要內容略...
public class CsvSampleReader implements Closeable{
//次要內容略...
private static final String CHARSET = "ISO8859-1";
//次要內容略...
private CsvSampleReader(File inputFile, SampleMetadata metadata, char separator, boolean useSaveSampleCfg) {
if (!(inputFile.isFile() && inputFile.canRead())) {
throw new IllegalArgumentException(inputFile.getAbsolutePath()
+ " does not exist or is not readable");
}
this.file = inputFile;
try {
this.reader = new BufferedReader(new InputStreamReader(
new FileInputStream(file), CHARSET), BUF_SIZE);
} catch (FileNotFoundException | UnsupportedEncodingException ex) {
throw new SampleException("Could not create file reader !", ex);
}
}
}
至此，問題原因得以確定。
