使用Comunica执行Wikidata SPARQL查询时解析失败的解决方法

问题重现 #

你使用的SPARQL查询语句：

SELECT ?item ?itemLabel
WHERE
{
  ?item wdt:P31 wd:Q146.
}

执行命令：

comunica-sparql -f query.sparql -i https://query.wikidata.org/sparql

出现错误：

Query parsing failed: none of the configured parsers were able to the query "SELECT ?item ?itemLabel
WHERE
{
  ?item wdt:P31 wd:Q146.
}
"
    Error messages of failing actors:
        This actor can only parse SPARQL queries
        This actor can only parse GraphQL queries

解决方案 #

1. 调整命令参数顺序 #

Comunica对参数顺序有要求，把数据源参数-i放在查询文件参数-f前面，重新执行：

comunica-sparql -i https://query.wikidata.org/sparql -f query.sparql

2. 跳过文件直接传查询语句验证 #

绕开文件读取环节，直接在命令行传入查询语句，确认查询本身是否可被解析：

comunica-sparql -i https://query.wikidata.org/sparql "SELECT ?item ?itemLabel WHERE { ?item wdt:P31 wd:Q146. }"

3. 检查查询文件的编码与格式 #

• 用纯文本编辑器打开query.sparql，确保文件编码为UTF-8，没有多余的不可见字符（比如特殊换行符），保存后重新执行命令。
• 可以尝试新建一个空白文件，手动粘贴查询语句再保存，避免原文件的格式问题。

4. 更新Comunica到最新版本 #

如果是版本兼容问题，执行以下命令更新全局安装的Comunica：

npm update -g @comunica/query-sparql

补充：完善查询以获取标签结果 #

虽然这不是解析失败的原因，但原查询默认可能不会返回?itemLabel的实际值，补充标签服务声明可以让结果更完整：

SELECT ?item ?itemLabel
WHERE
{
  ?item wdt:P31 wd:Q146.
  SERVICE wikibase:label { bd:serviceParam wikibase:language "en". }
}

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