使用f-string构建SPARQL查询时遭遇QueryBadFormed错误求助

问题背景 #

使用Python的SPARQLWrapper库查询意大利参议院公共SPARQL端点，遍历姓名列表通过f-string构建SPARQL语句时，触发QueryBadFormed错误，提示SPARQL表达式中存在无效字符%，但直接打印的查询语句看起来格式正常。

样本数据：

longnames = ['Lars Danielsson', 'Giorgia Meloni', 'Ursula von der Leyen', 'Filippo Mannino', 'Matteo Piantedosi', 'Lamberto Giannini']

错误原因 #

1. GET请求的URL编码冲突：SPARQLWrapper默认用GET方法发送查询，会将查询中的换行、空格等字符做URL编码（比如换行\n被编码为%0A），而Virtuoso端点解析时错误地将这些编码后的%字符视为查询本身的内容，导致语法报错。
2. 冗余空白放大问题：原查询包含大量缩进和换行，虽语法合法，但进一步加剧了GET请求编码后的解析冲突。

修复方案 #

方案1：切换为POST请求 #

将查询发送方式改为POST，查询内容放在请求体中，完全避开URL编码带来的解析问题：

sparql.setMethod('POST')

方案2：压缩查询语句空白 #

去掉查询中多余的换行和缩进，让语句更紧凑，减少编码后的字符冲突概率：

sparqlquery = f"""PREFIX osr:<http://dati.senato.it/osr/>
SELECT * WHERE {{
  ?uri a osr:Senatore. 
  ?uri rdfs:label '{label}'^^xsd:string.
}}"""

方案3：使用参数绑定（推荐写法） #

避免直接用f-string拼接字符串，改用SPARQL的参数绑定功能，既安全又能规避字符转义问题：

sparqlquery = """
PREFIX osr:<http://dati.senato.it/osr/>
SELECT * WHERE {{
    ?uri a osr:Senatore. 
    ?uri rdfs:label ?name.
}}
"""
sparql.setQuery(sparqlquery)
sparql.addParameter("name", label)

完整修复代码示例 #

from SPARQLWrapper import SPARQLWrapper, JSON

endpoint = "http://dati.senato.it/sparql"
sparql = SPARQLWrapper(endpoint)
sparql.setReturnFormat(JSON)
# 改用POST方法解决编码冲突
sparql.setMethod('POST')

longnames = ['Lars Danielsson', 'Giorgia Meloni', 'Ursula von der Leyen', 'Filippo Mannino', 'Matteo Piantedosi', 'Lamberto Giannini']

for label in longnames:
    # 压缩查询空白，保留可读性的同时避免编码问题
    sparqlquery = f"""PREFIX osr:<http://dati.senato.it/osr/>
SELECT * WHERE {{
  ?uri a osr:Senatore. 
  ?uri rdfs:label '{label}'^^xsd:string.
}}"""
    print(f"{endpoint} ---> {sparqlquery}")
    sparql.setQuery(sparqlquery)
    try:
        ret = sparql.queryAndConvert()
        for r in ret["results"]["bindings"]:
            print(r)
    except Exception as e:
        print(e)

补充说明 #

• 参数绑定是更规范的写法，能避免类似SQL注入的风险，同时适配带特殊字符（如单引号）的姓名。
• 部分公共SPARQL端点对GET请求的长度有限制，POST方法也能规避该问题。

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