Spring Restdocs 源 gradle 构建在测试期间失败答案

【问题标题】：Spring Restdocs source gradle build fails during testSpring Restdocs 源 gradle 构建在测试期间失败
【发布时间】：2016-07-23 00:07:23
【问题描述】：

我已经下载了带有 1.1.0-RELEASE 标记的 Spring RESTdocs 源代码的副本，但是“gradlew build”在测试阶段失败了。 502 次测试中有 273 次失败，此错误有所不同： org.springframework.restdocs.request.RequestPartsSnippetTests > requestPartsWithOptionalColumn[Markdown] FAILED java.lang.AssertionError: Expected: is adoc snippetPart | Optional | Description ---- | -------- | ----------- a | true | one b | false | two but: was:Part | Optional | Description ---- | -------- | ----------- a | true | one b | false | two

问题看起来是字符串“adoc sn-p”以开头为前缀的预期输出。我认为这是不对的，尽管我可以在 AbstractContentSnippetMatcher.describeTo() 中看到为什么会发生这种情况，而且看起来不是很有条件，所以可能是测试的实际结果有误？

我没有对源代码进行任何更改*，但我没有看到其他人报告这个问题，所以我很困惑。我对 gradle 完全陌生。我需要设置某种配置以使测试通过吗？我应该使用不同的目标吗？

（好的... 1 个小改动：我从 checkStyle 中删除了文件末尾换行检查 - 我正在从 Github 下载到 Windows PC。）

【问题讨论】：

有一个Windows-specific CI job，所有测试都通过了（除了在 Linux 上运行的测试），所以我不认为存在普遍问题。您的环境大多有所不同。我想知道它是否与行尾有关。你是如何设置 Git 的（例如core.autocrlf）？
@JulieC 您似乎使用了 2 个不同的帐户来编辑您的问题（因此将您的编辑放入审核队列）。你能坚持一个帐户吗？
@AndyWilkinson 我同意，一定是环保的，我只是不知道是什么。我尝试在 Windows 和 cygwin 命令行中运行构建，但结果相同。我使用 .zip 文件（v1.1.0.RELEASE）下载，所以我没有 github 设置。您能否评论一下我的两条输出中哪一条在您的环境中是正确的？即预期结果还是实际结果？也许如果我知道我应该追逐机器中的哪个幽灵......
@PeterBrittain 感谢您指出这一点，它解释了很多！使用两个浏览器，我猜其中一个缓存了一些神秘的凭据。我会去尝试清除它。
我不确定这是否相关，但我在从 Netbeans IDE 运行单个测试时遇到了问题。看来 Window/Netbeans/NewLines 是一个可怕的组合。从终端运行套件没有问题。你可以在SnippetMatchers 中看到我必须做的here。这似乎是您面临问题的位置。

标签： spring-restdocs

【解决方案1】：

问题在于 zip 中的文件具有 Unix 风格的行尾，但是在 Windows 上运行时，Checkstyle 和测试需要 Windows 风格的行尾。

通常，Windows Git 客户端会在您签出代码时通过转换行尾来为您处理此问题。例如，Git for Windows 的默认配置是使用 Windows 样式的行结尾签出代码，但使用 Windows 样式的行结尾提交更改。

您也许可以找到一个 Windows 实用程序，它将行尾从 LF 批量转换为 CRLF。如果做不到这一点，安装 Git 客户端（例如我上面链接到的适用于 Windows 的 Git）可能是最简单的，确保它被配置为执行行结束转换，然后：

> git clone https://github.com/spring-projects/spring-restdocs
> cd spring-restdocs
> gradlew build

【讨论】：