[error occurred in build.] ImportError: cannot import name 'environmentfilter' from 'jinja2'

[lixiang007666]

Details

• Read the Docs project URL: https://readthedocs.org/projects/libai/
• Build URL (if applicable): https://readthedocs.org/projects/libai/builds/16464179/
• Read the Docs username (if applicable): https://readthedocs.org/profiles/Lixiang666007/

Expected Result

Without any changes to the doc, the following error suddenly appeared!

/home/docs/checkouts/readthedocs.org/user_builds/libai/envs/latest/bin/python -m sphinx -T -E -b html -d _build/doctrees -D language=en . _build/html
Traceback (most recent call last):
  File "/home/docs/.asdf/installs/python/3.7.12/lib/python3.7/runpy.py", line 193, in _run_module_as_main
    "__main__", mod_spec)
  File "/home/docs/.asdf/installs/python/3.7.12/lib/python3.7/runpy.py", line 85, in _run_code
    exec(code, run_globals)
  File "/home/docs/checkouts/readthedocs.org/user_builds/libai/envs/latest/lib/python3.7/site-packages/sphinx/__main__.py", line 13, in <module>
    from sphinx.cmd.build import main
  File "/home/docs/checkouts/readthedocs.org/user_builds/libai/envs/latest/lib/python3.7/site-packages/sphinx/cmd/build.py", line 25, in <module>
    from sphinx.application import Sphinx
  File "/home/docs/checkouts/readthedocs.org/user_builds/libai/envs/latest/lib/python3.7/site-packages/sphinx/application.py", line 43, in <module>
    from sphinx.registry import SphinxComponentRegistry
  File "/home/docs/checkouts/readthedocs.org/user_builds/libai/envs/latest/lib/python3.7/site-packages/sphinx/registry.py", line 24, in <module>
    from sphinx.builders import Builder
  File "/home/docs/checkouts/readthedocs.org/user_builds/libai/envs/latest/lib/python3.7/site-packages/sphinx/builders/__init__.py", line 26, in <module>
    from sphinx.util import import_object, logging, progress_message, rst, status_iterator
  File "/home/docs/checkouts/readthedocs.org/user_builds/libai/envs/latest/lib/python3.7/site-packages/sphinx/util/rst.py", line 21, in <module>
    from jinja2 import Environment, environmentfilter
ImportError: cannot import name 'environmentfilter' from 'jinja2' (/home/docs/checkouts/rea

Actual Result

The previous builds were normal, I didn't make any changes.

[Brawcks]

Same here 👍

[ChuanXu1]

This may be due to the latest release of Jinja2. Requiring Jinja2<3.1 fixes my issue.

[lixiang007666]

sphinx-doc/sphinx#10291

[ChuanXu1]

This may be due to the latest release of Jinja2. Requiring Jinja2<3.1 fixes my issue.

I didn't import Jinja module manually, How did you fix it?👀

you can explicitly add Jinja2<3.1 in the configuration

[ericholscher]

This is a dupe of the comment yesterday. The best approach is to fully pin your dependencies as noted here:

#9037 (comment)