Windows 7下Jython 2.7.0用pip安装jinja2报错的解决及兼容模板推荐

安装报错的根因定位 #

日志末尾输出的No distributions at all found for jinja2属于pip连接失败后的兜底提示，并非当前环境不存在适配Jython的模板库版本。
从日志中的javax.net.ssl.SSLException: Tag mismatch! during SSL handshake可确认，安装失败的核心原因是当前环境搭载的pip 1.6.dev1版本过旧，其内置的Jython SSL栈与新版PyPI服务端的TLS加密套件不兼容，握手阶段直接中断，pip未完成包检索动作就触发了兜底报错。日志开头的Java反射访问告警，是Jython 2.7.0搭配高版本Java运行时的常规兼容提示，不影响实际功能运行。

Jinja2 正常安装的分步操作 #

所有操作均在Jython安装目录的bin路径下执行：

• 临时切换HTTP源完成基础组件升级，解决旧版pip的兼容问题，执行命令：
  pip install --index-url http://pypi.python.org/simple/ --trusted-host pypi.python.org setuptools --upgrade
• 升级完成后，沿用HTTP源完成Jinja2安装，执行命令：
  pip install --index-url http://pypi.python.org/simple/ --trusted-host pypi.python.org/simple/ jinja2
• 若仍出现SSL握手报错，可通过显式指定JVM运行参数绕开旧版Netty SSL模块的已知bug，执行命令：
  jython -Djava.net.preferIPv4Stack=true -m pip install jinja2 --index-url http://pypi.python.org/simple/
• 安装完成后执行以下命令验证可用性，能正常输出版本号即代表安装成功：
  jython -c "import jinja2; print(jinja2.__version__)"

可在Jython环境正常运行的HTML模板库推荐 #

以下模板库均完成Jython 2.7.0兼容适配，无需额外改造即可稳定运行：

• Jinja2：2.11.3及以上版本原生支持Jython 2.7，模板语法完整，生态覆盖全面，支持模板继承、自定义过滤器、HTML转义等所有渲染所需能力，为当前优先推荐选项
• Cheetah3：2.0.0及以上版本兼容Jython，对旧版Cheetah脚本的迁移成本低，语法灵活，适合维护早期基于Cheetah开发的项目
• StringTemplate：可通过Jython的Java互操作能力直接调用，渲染性能稳定，适合需要和现有Java业务代码深度耦合的场景
• Mako：1.1.6版本通过Jython 2.7兼容测试，渲染速度快，支持内置模板缓存，适合高频率渲染的场景

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