C#/.NET中Neo4j查询的引号转义、变音符号及大小写不敏感处理

针对C#/.NET中调用Neo4j的场景，要实现引号自动转义、变音符号适配、大小写不敏感匹配，可按以下步骤改造查询与代码：

1. 改造Cypher查询逻辑 #

原生函数实现（无需依赖APOC） #

通过Neo4j原生的normalize、replace、toLower函数，统一处理字符串的变音符号与大小写，确保匹配一致性：

MATCH (e)-[:BELONGS_TO]->(t:Tenant) 
WHERE t.id = $id 
  AND (e:Unit OR e:UnitInactive) 
  AND toLower(replace(normalize(e.name, 'NFD'), '[\\p{Mn}]', '')) 
      contains toLower(replace(normalize($queryName, 'NFD'), '[\\p{Mn}]', ''))
RETURN e

• normalize(..., 'NFD')：将带变音的字符（如ão）拆分为基础字符+独立变音标记
• replace(..., '[\\p{Mn}]', '')：移除所有Unicode非间距变音标记，把João转为Joao
• toLower()：统一转为小写，实现大小写不敏感匹配

简化版（依赖APOC库） #

如果项目已引入Neo4j AOC扩展库，可用apoc.text.clean一键处理变音符号、大小写与特殊字符：

MATCH (e)-[:BELONGS_TO]->(t:Tenant) 
WHERE t.id = $id 
  AND (e:Unit OR e:UnitInactive) 
  AND apoc.text.clean(e.name) contains apoc.text.clean($queryName)
RETURN e

2. C#/.NET代码中的参数化实现（自动处理引号转义） #

绝对不要手动拼接查询字符串，使用Neo4j .NET Driver的参数化查询机制，自动处理单引号（如Mary's）等特殊字符的转义，同时避免Cypher注入风险：

using Neo4j.Driver;

// 定义参数化查询模板
var cypherQuery = @"
MATCH (e)-[:BELONGS_TO]->(t:Tenant) 
WHERE t.id = $id 
  AND (e:Unit OR e:UnitInactive) 
  AND toLower(replace(normalize(e.name, 'NFD'), '[\\p{Mn}]', '')) 
      contains toLower(replace(normalize($queryName, 'NFD'), '[\\p{Mn}]', ''))
RETURN e";

// 构建查询参数
var parameters = new Dictionary<string, object>
{
    { "id", 123 }, // 替换为实际租户ID
    { "queryName", "Mary's" } // 直接传入带特殊字符的搜索值，如"João"
};

// 执行查询
using var driver = GraphDatabase.Driver("neo4j://你的Neo4j地址:7687", AuthTokens.Basic("用户名", "密码"));
using var session = driver.Session();
var resultCursor = session.Run(cypherQuery, parameters);

// 解析结果
var matchedEntities = resultCursor.Select(record => record["e"].As<INode>()).ToList();

3. 核心优势说明 #

• 引号转义：参数化查询自动处理所有特殊字符（单引号、双引号、反斜杠等），无需手动编写转义逻辑
• 变音符号适配：通过字符标准化，确保带变音的输入（如João）与存储值能正确匹配
• 大小写不敏感：统一转为小写后匹配，消除大小写差异对结果的影响

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