Jinja2 NativeTemplate渲染含双引号的PostgreSQL路径字符串时的转义异常问题咨询

刚碰到这种路径被转义搞坏的情况确实头疼，我帮你梳理清楚问题根源和可行的解决方案：

问题到底出在哪？ #

你已经精准排查到了核心——Jinja2的NativeEnvironment在渲染时会调用native_concat方法，里面默认会对输出执行ast.literal_eval()。这个函数的作用是把字符串当成Python字面量解析，所以当你的路径被包裹在双引号里时，它会把\2、\20这类序列当成八进制转义字符处理：\2变成\x02（ASCII控制字符），\20变成\x82，最终把好好的路径拆得面目全非。而去掉双引号后，传入的是原生字符串，literal_eval()直接返回原内容，所以就正常了。

几种靠谱的解决办法 #

1. 先剥掉双引号再渲染

既然不带双引号的路径能正常工作，那最简单的办法就是把从数据库读出来的带"的路径先处理一下，去掉首尾的引号标记：

import jinja2

env = jinja2.nativetypes.NativeEnvironment()
# 数据库读取的原始路径
path_from_db = '"G:\\Shared drives\\2 test\\2021\\08.2021\\test.xlsx"'
# 清理掉首尾的"
clean_path = path_from_db.strip('"')
# 渲染
result = env.from_string('{{ path }}').render(path=clean_path)
print(result)  # 输出：G:\Shared drives\2 test\2021\08.2021\test.xlsx

2. 给反斜杠做双重转义

如果必须保留双引号，那可以把路径里的单个反斜杠换成两个——这样literal_eval()解析后，会把两个反斜杠还原成一个，刚好是你要的原始路径：

# 替换反斜杠
escaped_path = path_from_db.replace('\\', '\\\\')
result = env.from_string('{{ path }}').render(path=escaped_path)
print(repr(result))  # 输出：'"G:\\Shared drives\\2 test\\2021\\08.2021\\test.xlsx"'

3. 重写NativeEnvironment的native_concat方法

要是你离不开NativeEnvironment的其他特性，又想让路径跳过literal_eval()，可以自定义一个环境类，针对性地跳过对路径字符串的解析：

from jinja2.nativetypes import NativeEnvironment
import ast

class PathFriendlyNativeEnv(NativeEnvironment):
    def native_concat(self, values):
        out = super().native_concat(values)
        # 这里可以根据你的路径特征写判断逻辑，比如是否带双引号、是否有盘符
        if isinstance(out, str) and out.startswith('"') and out.endswith('"') and ':' in out:
            return out  # 直接返回原字符串，不做literal_eval
        # 其他内容还是按原逻辑处理
        try:
            return ast.literal_eval(out)
        except (ValueError, SyntaxError, MemoryError):
            return out

# 用自定义环境渲染
env = PathFriendlyNativeEnv()
result = env.from_string('{{ path }}').render(path=path_from_db)
print(result)  # 输出："G:\Shared drives\2 test\2021\08.2021\test.xlsx"

4. 换成普通的Jinja2 Environment

如果你的场景不需要NativeEnvironment的原生类型渲染（比如不需要把模板输出转成Python的列表、字典这类原生对象），直接用普通的Environment就行，它根本不会触发literal_eval()：

import jinja2

env = jinja2.Environment()
result = env.from_string('{{ path }}').render(path=path_from_db)
print(result)  # 输出："G:\Shared drives\2 test\2021\08.2021\test.xlsx"

验证结果 #

不管用哪种方法，都可以用repr()来检查最终的字符串是否符合预期，确保反斜杠都被正确保留：

print(repr(result))
# 期望得到：'"G:\\Shared drives\\2 test\\2021\\08.2021\\test.xlsx"'

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