在Flask项目中嵌入Goaccess统计报告页面遇Jinja2语法错误的解决咨询

问题原因 #

Goaccess生成的report.html使用的是Handlebars模板语法（比如{{#className}}这种块表达式），但Flask默认的模板引擎Jinja2会把这些{{}}标签当作自己的模板语法解析，而#在Jinja2里不是这样的用法，所以才会抛出TemplateSyntaxError: unexpected char '#'的错误。

方案1：不修改report.html，直接返回原始HTML内容 #

不要用render_template（它会触发Jinja2解析），而是直接读取report.html的文件内容，以纯HTML形式返回。修改你的路由代码如下：

from flask import current_app

@main.route("/report")
def report():
    # 获取report.html的正确路径
    report_file_path = current_app.root_path + "/templates/report.html"
    with open(report_file_path, "r", encoding="utf-8") as f:
        raw_html = f.read()
    return raw_html

这样Flask会直接把文件内容原封不动发送给浏览器，不会经过Jinja2的模板解析，Handlebars的语法就不会被误判为错误了。

方案2：将报告作为静态文件直接访问 #

如果方案1遇到资源路径问题（比如报告里的CSS/JS相对路径失效），可以把report.html和它依赖的所有静态资源（css、js、图片等）一起移到Flask项目的static目录下，然后通过两种方式访问：

1. 直接通过静态文件路由访问：http://你的域名/static/report.html
2. 或者添加一个专门的路由转发静态文件：

from flask import send_from_directory

@main.route("/report")
def report():
    return send_from_directory("static", "report.html")

这个方案更适合Goaccess报告这种自带完整资源的静态页面，避免路径适配问题。

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