在Maven网站部署期间生成JavaDocs时，会引发MalformedInputException错误

Question

我工作的组织使用RAML工具作为构建API文档的方式。该文档包含在JavaDocs中，作为补充资源，构成了我们客户的完整Maven网站。

在生成JavaDocs的过程中，进行Yaml合并文档时会遇到以下错误：

java.nio.charset.MalformedInputException: Input length = 1

虽然Maven构建成功，但随后的RAML生成器失败，因为API无法生成其索引文件（api.html）。

我意识到这个问题有点笼统，并且有几种方法可以构建站点文档。无需过多担心细节，我正在寻找引起原始问题的可能原因；造成java.nio.charset.MalformedInputException的常见原因是什么？

似乎字符编码可能是罪魁祸首，但是我最近的提交中已经在寻找不兼容的字符（UTF-8 / Unicode字符集），例如弯引号（智能引号），撇号。有什么建议吗？

Answer 1

我解决了自己的问题。花了一些时间，因为错误非常隐秘。但这给了我足够的信息。程序包名称的“字符集”部分表示可能存在不受支持的字符。

解决方案：一个智能单引号（unicode字符）将其变成JavaDoc注释，这在Yaml Merge作为Maven Site构建的一部分运行时中断了该过程。

罪魁祸首是

[’]而不是[']。 那是一个非常昂贵的角色！