尝试使用gitment评论系统过程中，配置完成后初始化评论出现验证失败问题(Error: Validation Failed)。

问题出现

第一次配置 gitment 时，按照官方文档进行如下设置：

1
2
3
4
5
6
7
8
9
10
11
12
13
const gitment = new Gitment({
  id: 'Your page ID', // optional
  owner: 'Your GitHub ID',
  repo: 'The repo to store comments',
  oauth: {
    client_id: 'Your client ID',
    client_secret: 'Your client secret',
  },
  // ...
  // For more available options, check out the documentation below
})

gitment.render('comments')

由于 id 这一项，默认为 window.location.pathname ，于是便删除了这一条。随后 push 到 github，初始化评论(Initialize Comments)时，浏览器边弹窗报错：

1
Error: Validation Failed

问题解决

经过一番摸索，疑似是因为 gitment 配置中 id 过长引起的。因为 gitment 是其作者基于 gitHub 的 issue 开发的，每一条 issue 会有两个 label，label 的最大长度限制为50个字符。这个问题多数人都遇到过，关于这个问题的讨论与建议在 gitment 的 issues 上出现过：Validation Failed ID长度问题建议，印证了前面的想法。问题找到了，那么我们设置一个长度较短的 id 就可以了。

起初想用 page.title 来作为 id，然而操作并不顺利，因为我的标题大部分是中文，而且长度也都不短，再通过 utf 转码会有一堆 % 占空间，长度必定更长。

最后决定使用 page.path 作为 id，因为我的 permalink 的配置有所更改，所以 page.path 的长度相对较短，重新设置后初始化成功，Initialize Comments 按钮变成了文字 No Comment Yet 。

关于我的 permalink 设置(在博客根目录的 config.yml 中)，只保留了 year 和 title：

1
2
3
xxx
permalink: :year/:title/
xxx

最后

由于我的 page.path 长度在50个字符以内，所以上述的设置能够成功。但这并不适合所有情况，具体情况具体分析，只要保证 id 在50个字符以内即可。