小能豆

为什么 sphinx 在 GitLab CI 中失败并显示代码 -4

py

我正在尝试构建我的 GitLab 项目的文档。尽管它在本地运行良好,但我收到了这个非常不直观的错误,没有任何正确的错误消息。关于可能发生的事情以及如何解决它的任何想法?

编辑:我通过毒物使用狮身人面像。

Running Sphinx v6.2.1
loading configurations for dlproject 0.0.post1.dev44+g68608a6 ...
Creating file /builds/repo/dlproject/docs/api/dlproject.rst.
Creating file /builds/repo/dlproject/docs/api/dlproject.data.rst.
Creating file /builds/repo/dlproject/docs/api/dlproject.design.rst.
Creating file /builds/repo/dlproject/docs/api/dlproject.model.rst.
Creating file /builds/repo/dlproject/docs/api/dlproject.sequence.rst.
Creating file /builds/repo/dlproject/docs/api/modules.rst.
making output directory... done
locale_dir /builds/repo/dlproject/docs/locales/en/LC_MESSAGES does not exists
loading intersphinx inventory from https://www.sphinx-doc.org/en/master/objects.inv...
loading intersphinx inventory from https://docs.python.org/3.10/objects.inv...
loading intersphinx inventory from https://matplotlib.org/objects.inv...
loading intersphinx inventory from https://numpy.org/doc/stable/objects.inv...
loading intersphinx inventory from https://scikit-learn.org/stable/objects.inv...
loading intersphinx inventory from https://pandas.pydata.org/pandas-docs/stable/objects.inv...
loading intersphinx inventory from https://docs.scipy.org/doc/scipy/reference/objects.inv...
loading intersphinx inventory from https://setuptools.pypa.io/en/stable/objects.inv...
loading intersphinx inventory from https://pyscaffold.org/en/stable/objects.inv...
intersphinx inventory has moved: https://matplotlib.org/objects.inv -> https://matplotlib.org/stable/objects.inv
intersphinx inventory has moved: https://docs.scipy.org/doc/scipy/reference/objects.inv -> https://docs.scipy.org/doc/scipy/objects.inv
[autosummary] generating autosummary for: api/dlproject.data.rst, api/dlproject.design.rst, api/dlproject.model.rst, api/dlproject.rst, api/dlproject.sequence.rst, api/modules.rst, authors.rst, changelog.rst, contributing.rst, index.rst, license.rst, readme.rst
docs: exit -4 (6.71 seconds) /builds/repo/dlproject> sphinx-build -T -v --color -b html -d /builds/repo/dlproject/docs/_build/doctrees /builds/repo/dlproject/docs /builds/repo/dlproject/docs/_build/html pid=348
.pkg: _exit> python /usr/local/lib/python3.10/site-packages/pyproject_api/_backend.py True setuptools.build_meta
  docs: FAIL code -4 (345.71=setup[339.00]+cmd[6.71] seconds)
  evaluation failed :( (346.09 seconds)
Cleaning up project directory and file based variables
00:02
ERROR: Job failed: exit code 1

阅读 88

收藏
2023-05-28

共1个答案

小能豆

这个错误看起来是在构建Sphinx文档时出现的问题。根据错误消息,这是一个非常不直观的错误,并且没有给出明确的错误信息来指导你解决问题。不过,我可以给你一些建议来尝试解决这个问题。

首先,你可以尝试检查以下几个可能的原因:

  1. Sphinx版本:确保你正在使用最新版本的Sphinx。你可以尝试更新Sphinx到最新版本并重新运行构建命令。
  2. 依赖项:检查你的项目依赖项是否正确安装并配置。确保你的项目中的依赖项与Sphinx的要求兼容,并已正确安装。
  3. 网络连接:Sphinx在构建文档时需要访问一些外部链接(如intersphinx inventory)。确保你的网络连接正常,可以访问这些链接。有时网络问题可能导致构建失败。
  4. 本地配置:检查你的本地配置是否正确设置。确保你的环境变量、路径设置等都正确,并且没有与Sphinx构建冲突的配置。

如果以上步骤没有解决问题,你可以尝试以下操作:

  1. 清理构建:运行清理命令以清理之前的构建文件。然后重新运行构建命令,看看是否有任何改进。
  2. 调试输出:尝试增加Sphinx构建命令的调试输出级别。这可以提供更详细的信息,帮助你找到问题所在。例如,你可以尝试添加-v-vv标志来增加详细程度。
  3. 查看日志文件:如果有生成的日志文件,尝试查看其中的详细错误信息。有时错误消息可能会记录在日志文件中,帮助你确定问题所在。

希望这些提示能帮助你解决问题。如果问题仍然存在,请提供更多细节,例如你的操作系统、Sphinx版本、项目依赖项等,这样我可以更好地帮助你。

2023-05-28