Mac系统无法启动JMeter 5.4.1版本报错问题求助

故障报错信息 #

Error: Could not find or load main class 6.bin....docs.images.jmeter_square.png
Caused by: java.lang.ClassNotFoundException: 6/bin////docs/images/jmeter_square/png
logout
Saving session...
...copying shared history...
...saving history...truncating history files...
...completed.
[Process completed]

故障根因 #

该问题是JMeter 5.4.1版本启动脚本的路径解析逻辑缺陷导致：当JMeter的存放路径包含空格、中文、/、&等特殊字符，或者父目录命名包含特殊格式的字符组合时，JVM会错误把路径片段识别为要加载的主类名，触发类找不到异常。
同一设备可正常启动JMeter 5.3是因为5.3版本的启动脚本路径解析逻辑兼容性更强，不存在该缺陷。

解决步骤 #

• 检查JMeter 5.4.1的完整存放路径，移除路径中所有的中文、空格、特殊符号，父目录不要使用带特殊后缀的命名（比如带/拼接的数字名称）
• 将JMeter 5.4.1根目录移动到纯英文无特殊字符的路径下，比如~/Applications/目录，根目录保持默认命名apache-jmeter-5.4.1即可，不要自行修改
• 若移动路径后仍无法启动，右键点击JMeter启动批处理文件，选择「显示包内容」，依次进入Contents→MacOS目录，直接执行目录下的启动脚本，排查是否是快捷方式路径缓存问题
• 上述操作均无效时，重新下载官方JMeter 5.4.1安装包，确认安装包完整后再解压使用，排除安装包损坏导致的解析异常

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