aiohttp搭配jinja2如何实现静态资源cache busting版本注入

web.static(append_version=True) 配置不会自动扫描、替换模板中硬编码的静态资源路径，它的作用只有两个：

• 支持aiohttp正确识别携带?v=xxx版本参数的静态资源请求，不会因查询参数存在返回404
• 对外提供带版本号的静态路径生成方法，供模板或业务代码调用时，自动基于文件内容计算哈希、拼接版本参数
  模板中硬编码的src路径属于纯静态字符串，渲染过程不会触发版本号追加逻辑，因此输出内容和原始写法完全一致。

• 第一步：对齐静态路由前缀配置
  确保静态路由的对外访问前缀和你资源实际访问路径一致，例如本地静态资源目录为./static，对外访问前缀设为/static时，路由配置如下：

  web.static('/static', './static', append_version=True)
  

  注意：路由配置的前缀必须和后续路径生成时传入的前缀完全匹配，否则会出现资源404问题

• 第二步：模板中调用内置方法生成静态路径
  采用官方aiohttp_jinja2.setup()初始化Jinja2环境时，模板上下文会自动注入static辅助函数，不需要手动注册。替换模板中硬编码的路径写法，改为调用该函数生成地址：

  <img class="logo" src="{{ static('/static/images/logo.png') }}">
  

  模板渲染后会自动拼接基于文件内容生成的哈希版本参数，最终输出的HTML效果为：

  <img class="logo" src="/static/images/logo.png?v=文件内容对应的哈希值">
  

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