在Eleventy网站配置Google for Jobs时URL变量无法生成有效链接的问题排查

可能的原因及对应解法 #

1. 自定义JSON数据未配置URL相关字段 #

如果你的职位数据存在_data/jobs.json这类自定义JSON文件里，Eleventy不会自动给这些数据生成url属性。你得手动在数据里加slug或者完整url字段：

// _data/jobs.json示例
[
  {
    "title": "前端开发工程师",
    "slug": "frontend-developer",
    // 也可以直接写完整URL
    // "url": "https://yourdomain.com/jobs/frontend-developer/"
    // 其他职位字段...
  }
]

之后在模板里用站点域名+slug拼接完整URL：

{% for job in jobs %}
  "url": "{{ site.url }}/jobs/{{ job.slug }}/",
{% endfor %}

注意：site.url需要在_data/site.json里提前配置，比如{"url": "https://你的域名.com"}

2. 遍历变量名不匹配 #

检查模板里的循环变量名，比如你写的是{% for job in jobs %}，那调用URL时就得用job.url，如果写成post.url肯定会空——变量名必须严格对应循环里的别名。

3. 职位页面的Permalink配置错误 #

如果职位是单独的页面（比如jobs/frontend-developer.njk），得确保页面头部的permalink设置正确，Eleventy才会生成有效的url属性：

---
permalink: "/jobs/{{ page.fileSlug }}/"
title: "前端开发工程师"
---

这时如果你的jobs是从Eleventy集合（比如collections.jobs）获取的，遍历集合就能拿到正确的URL：

{% for job in collections.jobs %}
  "url": "{{ job.url | url | safe }}",
{% endfor %}

4. 模板上下文传递问题 #

如果google-jobs.njk是作为组件被引入到layout里，要确保它能拿到正确的数据上下文。比如如果jobs是当前页面的局部数据，需要在引入时明确传递：

{% include "google-jobs.njk" with { jobs: page.jobs } %}

快速排查技巧 #

直接在模板里打印整个job对象，看看里面的属性结构：

{% for job in jobs %}
  {{ job | dump }}
{% endfor %}

这样就能清楚看到job里到底有没有URL相关字段，以及字段名是什么，再针对性调整就行。

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