我工作的组织使用 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 字符集(，例如大引号(智能引号(、撇号符号。 有什么建议吗？
我解决了自己的问题。 这需要一些时间，因为错误非常神秘。 但它给了我足够的信息。 包名称的"字符集"部分指示可能存在不受支持的字符。
解决方案：一个智能撇号(unicode字符(将其制作成JavaDoc注释，当Yaml Merge作为Maven Site构建的一部分运行时，它破坏了该过程。
[ ' ]而不是 [ ' ] 是罪魁祸首。这是一个非常昂贵的角色！