如何避免Neo4j调用Wikidata查询时出现不必要的二次编码问题

问题原因 #

你遇到的400错误确实是URL二次编码导致：

• 你手动调用apoc.text.urlencode(sparql)把SPARQL里的特殊字符（比如换行、引号、大括号）转成了%XX格式的编码串
• apoc.load.jsonParams在发起请求前，会自动对整个URL再做一次编码，把你手动生成的%符号转成了%25，最终所有编码前缀都变成了%25XX，和你在报错里看到的一致。

你之前用REPLACE()失效的原因是，REPLACE()是修改你在Cypher层拼接好的URL字符串，但二次编码是发生在APOC内部发起请求的阶段，Cypher层替换完成的字符串传给APOC之后还是会被再次编码，所以无效。

解决办法 #

方案1：移除手动编码步骤

直接把未编码的SPARQL拼到URL后即可，APOC会自动完成一次正确的编码：

MATCH (player:Player)
WHERE player.name = "Nick Kyrgios"
WITH "SELECT *
WHERE { ?person wdt:P106 wd:Q10833314 ;
                rdfs:label \"" + player.name + "\"@en ;
                wdt:P569 ?dateOfBirth ;
                wdt:P27 [ rdfs:label ?countryName ] .
       filter(lang(?countryName) = \"en\")
}" AS sparql
CALL apoc.load.jsonParams(
  "https://query.wikidata.org/sparql?query=" + sparql,
  { Accept: "application/sparql-results+json"},
  null
)
YIELD value
RETURN value

方案2：用POST方式传递查询（更稳定）

Wikidata SPARQL端点支持POST请求，把查询放在请求体里可以完全规避URL编码问题，也适合更长的SPARQL语句：

MATCH (player:Player)
WHERE player.name = "Nick Kyrgios"
WITH "SELECT *
WHERE { ?person wdt:P106 wd:Q10833314 ;
                rdfs:label \"" + player.name + "\"@en ;
                wdt:P569 ?dateOfBirth ;
                wdt:P27 [ rdfs:label ?countryName ] .
       filter(lang(?countryName) = \"en\")
}" AS sparql
CALL apoc.load.jsonParams(
  "https://query.wikidata.org/sparql",
  { Accept: "application/sparql-results+json", "Content-Type": "application/x-www-form-urlencoded" },
  "query=" + apoc.text.urlencode(sparql)
)
YIELD value
RETURN value

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