由于個(gè)人在JMeter 3.0的實(shí)際應(yīng)用中，腳本中的Test Plan/Sampler等元件命名都沒有使用中文，所以在之前介紹Dashboard Report特性的博客(原文戳這里))成文時(shí)弓熏，沒有提到關(guān)于中文的問題会前。之后有朋友反饋饭聚，Sampler名稱為中文時(shí)，生成的報(bào)告中展示為亂碼营搅，自己測試，確實(shí)如此梆砸。
如圖转质，腳本包含兩個(gè)命名為中文的Sampler：
執(zhí)行測試后，生成的Dashboard Report圖表中文亂碼：
于是通過查看官方文檔和源碼帖世，找到原因并進(jìn)行了解決休蟹，原打算直接追加到之前那篇文章沸枯，但考慮到篇幅過長，于是決定新成一文赂弓，然后在之前的文章中補(bǔ)充鏈接绑榴。
二. 解決方案
先上解決方案：修改JMeter report模塊讀取數(shù)據(jù)源碼中的字符集設(shè)置為UTF-8，編譯后替換到 JMETER_HOME\lib\ext\ApacheJMeter_core.jar 內(nèi)盈魁，這里會(huì)分享一個(gè)我處理好的一個(gè)jar包翔怎，但建議自己親自動(dòng)手：
基礎(chǔ)方案
1、在官網(wǎng) 下載頁面 下載 apache-jmeter-3.0_src.zip
2杨耙、相關(guān)源碼位置：
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 內(nèi)的原文件容握。當(dāng)然也可以直接對(duì)源碼重新編譯打包，但會(huì)比較費(fèi)時(shí)车柠。
效果如圖：
推薦方案
關(guān)于設(shè)置字符編碼剔氏，一個(gè)更推薦的方案是設(shè)置默認(rèn)字符編碼為UTF-8，同時(shí)支持.properties配置項(xiàng)堪遂。JMeter讀寫結(jié)果文件
(xml/csv)的字符編碼配置項(xiàng)是 ./bin/saveservice.properties 文件內(nèi)的 _file_encoding 介蛉，由
org.apache.jmeter.save.SaveService.getFileEncoding(String dflt)
讀取，當(dāng)沒有在配置相中指定時(shí)溶褪，將使用方法的入?yún)⒆鳛槟J(rèn)編碼币旧，這里我們傳入U(xiǎn)FT-8作為默認(rèn)格式，因此將基礎(chǔ)方案中的步驟3做如下變更：
private static final String CHARSET = SaveService.getFileEncoding(StandardCharsets.UTF_8.displayName());
編譯后替換即可猿妈。saveservice.properties文件的_file_encoding默認(rèn)已配置為UTF-8吹菱，多數(shù)情況下，我們不需要修改彭则。
文件分享
分享的文件和jar包是使用推薦方案進(jìn)行處理鳍刷。可以取用class文件自己替換進(jìn)本地的ApacheJMeter_core.jar俯抖，也可以直接下載分享的jar包替換本地對(duì)應(yīng)jar包输瓜。
· 單獨(dú)的CsvSampleReader.class文件： https://pan.baidu.com/s/1bo10QnX ，提取碼 ee68
·?處理完畢的ApacheJMeter_core.jar： https://pan.baidu.com/s/1mhKLwgw 芬萍，提取碼 id7h
注：github上可以看到j(luò)meter的trunk分支已經(jīng)將dashboard report的默認(rèn)字符編碼更改為UFT-8尤揣，本文的推薦方案即是官方更新中的實(shí)現(xiàn)方式。只是目前官方還沒有發(fā)布更新柬祠，所以自己動(dòng)手北戏。
三. 成因分析
Dashboard Report特性生成HTML圖表，使用JMeter記錄測試結(jié)果數(shù)據(jù)的文件 (命令行執(zhí)行時(shí) -l
指定的文件漫蛔，也可在圖形界面的監(jiān)聽器中指定嗜愈，作為基礎(chǔ)知識(shí)不在這里展開) 作為數(shù)據(jù)源旧蛾，Apache
FreeMarker作為模板引擎，默認(rèn)的模板位于JMETER_HOME\bin\report-template蠕嫁。
·?查看官方說明锨天，確認(rèn)沒有關(guān)于HTML報(bào)告字符編碼的配置項(xiàng)。
·?查看數(shù)據(jù)源文件拌阴，確定文件格式為UTF-8绍绘，文件中的中文正常可讀迟赃，排除數(shù)據(jù)源存在問題的可能陪拘。
·?查看生成的結(jié)果文件，主要數(shù)據(jù)在 指定路徑/content/js/graph.js 纤壁，任選一個(gè)圖表數(shù)據(jù)左刽，查看其標(biāo)簽的值(“l(fā)abel”:” * “)，顯示為亂碼酌媒，排除js解析成亂碼的可能欠痴。
·?此時(shí)首先想到Java文件讀取過程問題，從官方發(fā)布的源碼包查看源碼 src/core/org/apache/jmeter/report/core/CsvSampleReader 秒咨，發(fā)現(xiàn)代碼中字符編碼指定為ISO8859-1:
package org.apache.jmeter.report.core;
//次要內(nèi)容略...
public class CsvSampleReader implements Closeable{
//次要內(nèi)容略...
private static final String CHARSET = "ISO8859-1";
//次要內(nèi)容略...
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);
}
}
}
至此喇辽，問題原因得以確定。
