《Flask Web开发》学习笔记之bug--(5)【jinja2.exceptions.TemplateSyntaxError: Encountered unknown tag 'endlock'】

在阅读《Flask Web开发》过程中遇到一个模板语法错误,详细报错为`jinja2.exceptions.TemplateSyntaxError: Encountered unknown tag 'endlock'`。本文记录了这个问题的出现原因及解决方案,帮助读者避免类似问题。

# hello.py

from datetime import datetime
from flask import Flask, render_template
from flask_script import Manager
from flask_bootstrap import Bootstrap
from flask_moment import Moment
from flask_wtf import Form
from wtforms import StringField, SubmitField
from wtforms.validators import Required

class NameForm(Form):
	name = StringField('What is your name?', validators=[Required])
	submit = SubmitField('Submit')
		

app = Flask(__name__)

app.config['SECRET_KEY'] = 'hard to guess string'
manager = Manager(app)
bootstrap = Bootstrap(app)
moment = Moment(app)

@app.errorhandler(404)
def page_not_found(e):
	return render_template('404.html'), 404

@app.errorhandler(500)
def internal_server_error(e):
	return render_template('500.html'), 500

@app.route('/')
def index():
	return render_template('index.html', current_time=datetime.utcnow())

@app.route('/user/<name>')
def user(name):
	return render_template('user.html', name=name)


if __name__ == '__main__':
	manager.run()

{% extends "base.html" %}

{% block title %}Flasky - Internal Server Error{% endblock %}

{% block page_content %}
<div class="page-header">
	<h1>Internal Server Error</h1>
</div>
{% endlock %}

$ python3 hello.py runserver --host 0.0.0.0


报错信息:

* Running on http://0.0.0.0:5000/ (Press CTRL+C to quit)
[2017-07-13 14:17:47,740] ERROR in app: Exception on / [GET]
Traceback (most recent call last):
  File "/home/henry/.local/lib/python3.5/site-packages/flask/app.py", line 1982, in wsgi_app
    response = self.full_dispatch_request()
  File "/home/henry/.local/lib/python3.5/site-packages/flask/app.py", line 1614, in full_dispatch_request
    rv = self.handle_user_exception(e)
  File "/home/henry/.local/lib/python3.5/site-packages/flask/app.py", line 1517, in handle_user_exception
    reraise(exc_type, exc_value, tb)
  File "/home/henry/.local/lib/python3.5/site-packages/flask/_compat.py", line 33, in reraise
    raise value
  File "/home/henry/.local/lib/python3.5/site-packages/flask/app.py", line 1612, in full_dispatch_request
    rv = self.dispatch_request()
  File "/home/henry/.local/lib/python3.5/site-packages/flask/app.py", line 1598, in dispatch_request
    return self.view_functions[rule.endpoint](**req.view_args)
  File "hello.py", line 32, in index
    return render_template('index.html', current_time=datetime.utcnow())
  File "/home/henry/.local/lib/python3.5/site-packages/flask/templating.py", line 134, in render_template
    context, ctx.app)
  File "/home/henry/.local/lib/python3.5/site-packages/flask/templating.py", line 116, in _render
    rv = template.render(context)
  File "/home/henry/.local/lib/python3.5/site-packages/jinja2/environment.py", line 1008, in render
    return self.environment.handle_exception(exc_info, True)
  File "/home/henry/.local/lib/python3.5/site-packages/jinja2/environment.py", line 780, in handle_exception
    reraise(exc_type, exc_value, tb)
  File "/home/henry/.local/lib/python3.5/site-packages/jinja2/_compat.py", line 37, in reraise
    raise value.with_traceback(tb)
  File "/home/henry/dev/Flask_Web_Python_Henry/flask_henry/templates/index.html", line 2, in top-level template code
    {% import "bootstrap/wtf.html" as wtf %}
  File "/home/henry/dev/Flask_Web_Python_Henry/flask_henry/templates/base.html", line 1, in top-level template code
    {% extends "bootstrap/base.html" %}
  File "/home/henry/.local/lib/python3.5/site-packages/flask_bootstrap/templates/bootstrap/base.html", line 1, in top-level template code
    {% block doc -%}
  File "/home/henry/.local/lib/python3.5/site-packages/flask_bootstrap/templates/bootstrap/base.html", line 4, in block "doc"
    {%- block html %}
  File "/home/henry/.local/lib/python3.5/site-packages/flask_bootstrap/templates/bootstrap/base.html", line 20, in block "html"
    {% block body -%}
  File "/home/henry/.local/lib/python3.5/site-packages/flask_bootstrap/templates/bootstrap/base.html", line 23, in block "body"
    {% block content -%}
  File "/home/henry/dev/Flask_Web_Python_Henry/flask_henry/templates/base.html", line 35, in block "content"
    {% block page_content %}{% endblock %}
  File "/home/henry/dev/Flask_Web_Python_Henry/flask_henry/templates/index.html", line 10, in block "page_content"
    {{ wtf.quick_form(form) }}
  File "/home/henry/.local/lib/python3.5/site-packages/jinja2/runtime.py", line 553, in _invoke
    rv = self._func(*arguments)
  File "/home/henry/.local/lib/python3.5/site-packages/flask_bootstrap/templates/bootstrap/wtf.html", line 200, in template
    {{ form.hidden_tag() }}
  File "/home/henry/.local/lib/python3.5/site-packages/jinja2/environment.py", line 430, in getattr
    return getattr(obj, attribute)
jinja2.exceptions.UndefinedError: 'form' is undefined
127.0.0.1 - - [13/Jul/2017 14:17:47] "GET / HTTP/1.1" 500 -
Error on request:
Traceback (most recent call last):
  File "/home/henry/.local/lib/python3.5/site-packages/werkzeug/serving.py", line 209, in run_wsgi
    execute(self.server.app)
  File "/home/henry/.local/lib/python3.5/site-packages/werkzeug/serving.py", line 197, in execute
    application_iter = app(environ, start_response)
  File "/home/henry/.local/lib/python3.5/site-packages/flask/app.py", line 1997, in __call__
    return self.wsgi_app(environ, start_response)
  File "/home/henry/.local/lib/python3.5/site-packages/flask/app.py", line 1985, in wsgi_app
    response = self.handle_exception(e)
  File "/home/henry/.local/lib/python3.5/site-packages/flask/app.py", line 1547, in handle_exception
    return self.finalize_request(handler(e), from_error_handler=True)
  File "/home/henry/dev/Flask_Web_Python_Henry/flask_henry/hello.py", line 28, in internal_server_error
    return render_template('500.html'), 500
  File "/home/henry/.local/lib/python3.5/site-packages/flask/templating.py", line 133, in render_template
    return _render(ctx.app.jinja_env.get_or_select_template(template_name_or_list),
  File "/home/henry/.local/lib/python3.5/site-packages/jinja2/environment.py", line 869, in get_or_select_template
    return self.get_template(template_name_or_list, parent, globals)
  File "/home/henry/.local/lib/python3.5/site-packages/jinja2/environment.py", line 830, in get_template
    return self._load_template(name, self.make_globals(globals))
  File "/home/henry/.local/lib/python3.5/site-packages/jinja2/environment.py", line 804, in _load_template
    template = self.loader.load(self, name, globals)
  File "/home/henry/.local/lib/python3.5/site-packages/jinja2/loaders.py", line 125, in load
    code = environment.compile(source, name, filename)
  File "/home/henry/.local/lib/python3.5/site-packages/jinja2/environment.py", line 591, in compile
    self.handle_exception(exc_info, source_hint=source_hint)
  File "/home/henry/.local/lib/python3.5/site-packages/jinja2/environment.py", line 780, in handle_exception
    reraise(exc_type, exc_value, tb)
  File "/home/henry/.local/lib/python3.5/site-packages/jinja2/_compat.py", line 37, in reraise
    raise value.with_traceback(tb)
  File "/home/henry/dev/Flask_Web_Python_Henry/flask_henry/templates/500.html", line 9, in template
    {% endlock %}
  File "/home/henry/.local/lib/python3.5/site-packages/jinja2/environment.py", line 497, in _parse
    return Parser(self, source, name, encode_filename(filename)).parse()
  File "/home/henry/.local/lib/python3.5/site-packages/jinja2/parser.py", line 896, in parse
    result = nodes.Template(self.subparse(), lineno=1)
  File "/home/henry/.local/lib/python3.5/site-packages/jinja2/parser.py", line 878, in subparse
    rv = self.parse_statement()
  File "/home/henry/.local/lib/python3.5/site-packages/jinja2/parser.py", line 130, in parse_statement
    return getattr(self, 'parse_' + self.stream.current.value)()
  File "/home/henry/.local/lib/python3.5/site-packages/jinja2/parser.py", line 268, in parse_block
    node.body = self.parse_statements(('name:endblock',), drop_needle=True)
  File "/home/henry/.local/lib/python3.5/site-packages/jinja2/parser.py", line 165, in parse_statements
    result = self.subparse(end_tokens)
  File "/home/henry/.local/lib/python3.5/site-packages/jinja2/parser.py", line 878, in subparse
    rv = self.parse_statement()
  File "/home/henry/.local/lib/python3.5/site-packages/jinja2/parser.py", line 144, in parse_statement
    self.fail_unknown_tag(token.value, token.lineno)
  File "/home/henry/.local/lib/python3.5/site-packages/jinja2/parser.py", line 97, in fail_unknown_tag
    return self._fail_ut_eof(name, self._end_token_stack, lineno)
  File "/home/henry/.local/lib/python3.5/site-packages/jinja2/parser.py", line 90, in _fail_ut_eof
    self.fail(' '.join(message), lineno)
  File "/home/henry/.local/lib/python3.5/site-packages/jinja2/parser.py", line 59, in fail
    raise exc(msg, lineno, self.name, self.filename)
jinja2.exceptions.TemplateSyntaxError: Encountered unknown tag 'endlock'. Jinja was looking for the following tags: 'endblock'. The innermost block that needs to be closed is 'block'.

闭合处应该是【endblock】,少写了一个字母【b】





你遇到的错误: ``` jinja2.exceptions.TemplateSyntaxError: expected token 'end of print statement', got ':' ``` 是 **Jinja2 模板引擎** 中常见的语法错误,通常出现在使用 `{{ }}` 输出变量或表达式时,写入了不符合 Jinja2 语法规则的内容。 --- ### ✅ 错误原因 Jinja2 在 `{{ ... }}` 中期望是一个**完整的表达式结尾**,但遇到了一个冒号 `:`,说明你在模板中写了类似 Python 的语法(如字典、切片等),但格式不正确或不被支持。 --- ### 🔍 常见触发场景与修复方法 #### ❌ 场景 1:在模板中错误地使用字典字面量 ```jinja <!-- 错误 --> {{ {"name": "Alice", "age": 30} }} ``` > Jinja2 不允许直接在模板中创建字典字面量(除非启用了特殊扩展),而且 `:` 是分隔键值的符号,在解析时导致语法冲突。 ✅ **解决方案**:在后端准备好数据,传入模板: ```python # Flask 示例 @app.route('/user') def user(): user_data = {"name": "Alice", "age": 30} return render_template('user.html', user=user_data) ``` ```jinja <!-- 正确使用 --> <p>姓名:{{ user.name }}</p> <p>年龄:{{ user.age }}</p> ``` --- #### ❌ 场景 2:错误地使用切片或其他带冒号的语法 ```jinja <!-- 错误:试图在表达式中使用切片语法 --> {{ my_list[0:5] }} ``` 虽然 Jinja2 支持部分切片语法,但在某些上下文中可能报错,尤其是当解析器无法识别 `:` 时。 ✅ **正确写法(如果支持)**: ```jinja {{ my_list[:5] }} <!-- 取前5个元素 --> {{ my_list[::2] }} <!-- 步长为2 --> ``` 但如果仍然报错,说明你的 Jinja2 版本或配置不支持这种写法,或者你写的位置不对。 💡 **建议**:尽量避免复杂逻辑放在模板里,提前处理好数据。 ```python # 后端处理切片 users = User.query.all() top_5_users = users[:5] return render_template('index.html', top_5_users=top_5_users) ``` ```jinja <!-- 模板中只负责展示 --> <ul> {% for user in top_5_users %} <li>{{ user.name }}</li> {% endfor %} </ul> ``` --- #### ❌ 场景 3:在 `{{ }}` 中写了 Python 函数调用或表达式含 `:` ```jinja {{ def greet(): return "Hello" }} <!-- 完全错误!不能定义函数 --> {{ lambda x: x * 2 }} <!-- Lambda 不支持 --> ``` Jinja2 模板不是 Python REPL,不支持函数定义、lambda、复杂表达式。 ✅ **解决方案**:所有逻辑应在视图函数或模板过滤器中完成。 --- ### ✅ 如何安全地在 Jinja2 中使用表达式? | 正确示例 | 说明 | |--------|------| | `{{ name }}` | 输出变量 | | `{{ user.get('email') }}` | 调用方法(无参数) | | `{{ items|length }}` | 使用过滤器 | | `{{ list[0] }}` | 访问索引 | | `{{ list[:3] }}` | 切片(一般支持) | | `{{ a + b }}` | 简单运算 | 🚫 避免以下行为: - 定义变量 `{{ x = 1 }}`(除非启用 `do` 扩展) - 写字典 `{}` 或集合 `set()` - 使用 `:` 构造复杂结构 --- ### ✅ 开启高级语法(可选) 如果你确实需要更复杂的表达式(如字典),可以启用 Jinja2 的 **`expression-statement`** 扩展,并使用 `do`: ```python from jinja2 import Environment, FileSystemLoader env = Environment( loader=FileSystemLoader('templates'), extensions=['jinja2.ext.do'] ) ``` 然后在模板中: ```jinja {% do my_list.append("item") %} ``` 但这仍然**不能解决 `{{ {"key": "value"} }}` 这种写法的问题**,因为字典字面量在标准 Jinja2 中不受支持。 --- ### ✅ 总结 | 问题 | 解决方案 | |------|----------| | `expected token 'end of print statement', got ':'` | 避免在 `{{ }}` 中使用 `:` 创建字典或非法表达式 | | 使用 `{{ {"a": 1} }}` 报错 | 改为后端构造数据传入模板 | | 使用 `{{ list[0:5] }}` 报错 | 改为 `{{ list[:5] }}` 或提前切片 | | 模板中逻辑太复杂 | 遵循“模板只负责展示”的原则,把逻辑移到 Python 代码中 | --- ###
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值