java - 在 Maven 站点部署期间生成 JavaDoc 时，抛出 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

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

解决方案:单个智能撇号(unicode 字符)进入了 JavaDoc 注释，当 Yaml 合并作为 Maven 站点构建的一部分运行时，这破坏了流程。

[ ' ] 而不是 [ ' ] 是罪魁祸首。 这是一个非常昂贵的角色!