Jinja2模板文件已存在却抛出TemplateNotFound错误的原因排查

问题根源 #

你的代码存在核心逻辑错误：

• 已经通过FileSystemLoader指定templates目录作为模板查找的根路径
• 但调用env.get_template()时，传入的是完整绝对路径，而非相对于templates目录的模板文件名

Jinja2会在Loader指定的根目录下拼接你传入的路径，导致它去查找类似templates/Users/oskar/Desktop/test/templates/kustomization.jinja2这种不存在的路径，最终抛出TemplateNotFound。

修复后的完整代码 #

import jinja2
import os

# 定义实例变量
values = {
    "instance_name": "test",
    "instance_currency": "usd",
    "instance_locale": "en-us",
    "patch": "2023.06.01",
}

# 初始化Jinja2环境（用绝对路径指定模板目录，避免工作目录差异影响）
template_dir = os.path.join(os.path.dirname(os.path.abspath(__file__)), "templates")
loader = jinja2.FileSystemLoader(template_dir)
env = jinja2.Environment(loader=loader)

# 遍历模板目录下的文件
for template_name in os.listdir(template_dir):
    # 只处理.jinja2后缀的文件
    if not template_name.endswith(".jinja2"):
        continue
    # 直接传入模板文件名，而非绝对路径
    template = env.get_template(template_name)
    # 渲染模板并写入yaml文件
    file_path = os.path.join(template_dir, template_name[:-7] + ".yaml")
    with open(file_path, "w", encoding="utf8") as f:
        f.write(template.render(values))

关键修改说明 #

1. Loader路径优化：将FileSystemLoader('templates')改为FileSystemLoader(template_dir)，用绝对路径初始化Loader，彻底避免脚本执行时当前工作目录不同引发的路径问题。
2. 模板查找逻辑修正：循环中直接使用template_name（如kustomization.jinja2）作为get_template的参数，因为Loader已明确根目录，会自动在templates下匹配对应文件名的模板。
3. 增加文件过滤：添加.jinja2后缀判断，避免目录中其他文件干扰执行。

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