如何配置Jenkins使其在Django测试失败时标记构建为失败？

嗨，我之前也碰到过一模一样的问题！这种情况几乎都是因为Jenkins没捕获到Django测试命令返回的错误退出码，所以默认判定构建成功。咱们一步步来解决：

Django的manage.py test命令在测试失败时，默认会返回非0的退出码——这是Jenkins判断构建成败的核心依据。你可以先在本地跑一遍测试验证：

python manage.py test
echo $?  # 执行这条命令，测试失败时输出的数字应该不是0

如果本地返回的还是0，那可能是你自定义了测试运行器或者修改了Django的测试配置，但这种情况很少见，先排除掉。

Jenkins完全是根据每个构建步骤的退出码来判定成功/失败的，所以重点看你怎么调用测试命令：

• 如果用的是「Execute shell」步骤：
  直接写测试命令就行，千万别加|| true这种强制返回0的兜底命令，也别把测试命令放在一个不会传递错误码的脚本里（比如脚本最后没返回测试命令的退出码）。正确写法：

  python manage.py test
  

• 如果用的是Pipeline脚本：
  确保测试步骤没有被ignoreErrors包裹，也不要用returnStatus: true却不处理结果。最简单的正确写法：

  stage('Run Django Tests') {
      steps {
          sh 'python manage.py test'
      }
  }
  

  这样测试失败时，sh步骤会直接抛出错误，整个构建就会被标记为失败（变红）。

有时候前面测试已经失败了，但后续的清理、报告上传步骤返回了0，导致Jenkins认为整个构建成功。这种情况可以：

• 在「Execute shell」开头加set -e，让脚本遇到错误就立即终止：

  set -e
  python manage.py test
  # 后面的步骤只有测试成功才会执行
  

• 在Pipeline里主动检查测试结果并抛出错误：

  stage('Run Django Tests') {
      steps {
          script {
              def testExitCode = sh returnStatus: true, script: 'python manage.py test'
              if (testExitCode != 0) {
                  error "Django测试失败，退出码：${testExitCode}"
              }
          }
      }
  }
  

如果你用了JUnit插件来生成测试报告，要确保插件配置里勾选了「Fail the build if there are test failures」——不过这只是辅助，核心还是要让测试命令正确返回错误码，插件只是帮你展示更详细的失败用例。

如果是你提到的「我认为问题可能在于我未……」，大概率是没让Jenkins正确捕获到测试命令的错误退出码，上面的步骤应该能覆盖绝大多数情况。

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