文章摘要
GPT 4
此内容根据文章生成,并经过人工审核,仅用于文章内容的解释与总结
投诉
下面是参考的教程

并非原创仅作记录,上面的教程更加详细

hexo algolia 常见问题解决办法

执行algolia命令

1
hexo algolia

如果报错: Usage: hexo <command>

说明是没有安装hexo algolia插件

解决办法: 在hexo项目根目录执行npm安装命令

1
npm install hexo-algolia --save

报错: Please set an HEXO_ALGOLIA_INDEXING_KEY environment variable to enable content indexing.

1
2
ERROR [hexo-algolia] Please set an `HEXO_ALGOLIA_INDEXING_KEY` environment variable to enable content indexing.
ERROR >> Read https://npmjs.com/hexo-algolia#api-key for more informations.

原因: 需要一种像ssh一样的API秘钥,具体可以参考你在第一次使用algolia时候的教程

解决办法:export HEXO_ALGOLIA_INDEXING_KEY=你的Admin API Key

上述命令直接在windows cmd或powershell中执行会报错,需要在git bash中执行,不需要重启电脑,但该方法设置的环境变量为临时变量,重启会失效

我采用的主要是下面的方案

右键点击我的电脑 > 属性 > 高级系统设置 > 环境变量

在用户变量中点击新建,添加环境变量,变量名为HEXO_ALGOLIA_INDEXING_KEY 值为 Algolia admin key , 添加后点击确认,重启电脑后新增的环境变量生效(添加到系统变量中也是可以的)

环境变量设置成功后,执行hexo algolia 即可生成索引文件

报错:Method not allowed with this referer

1
2
3
4
5
6
INFO  [hexo-algolia] Testing HEXO_ALGOLIA_INDEXING_KEY permissions.
INFO Start processing
INFO [hexo-algolia] 47 records to index (post, page).
INFO [hexo-algolia] Indexing chunk 1 of 1 (47 records)
ERROR [hexo-algolia] Method not allowed with this referer
INFO [hexo-algolia] Indexing done.原因:使用了查询API key环境变量中设置的密钥需要为Admin KEY

解决办法:

登录Algolia官网,进入api key控制台

复制Admin API Key 修改环境变量HEXO_ALGOLIA_INDEXING_KEY 的值为该API Key即可

PS:__config.yml文件中配置的API密钥为搜索密钥(Search-Only API Key),请注意区分