基于Neo4j数据源的WPF自动补全文本框卡顿问题求助

嘿，我一眼就看出你遇到的问题了——每次在TextBox输入字符时应用直接冻结，这其实是几个常见的异步操作和资源管理坑导致的，让我帮你一步步修复：

核心问题分析 #

1. 异步死锁：你在TextBox_KeyUp里用了data.Result来获取异步方法的结果，这会直接阻塞UI线程，而异步查询又在等待UI线程的上下文，形成互相等待的死锁，直接导致应用冻结。
2. 重复创建数据库资源：每次按键都重新初始化Neo4j Driver和Session，这是非常昂贵的操作，严重拖慢响应速度。Neo4j Driver是设计成线程安全、可复用的，绝对不能每次查询都创建和销毁。
3. 不必要的重复查询：每次按键都去数据库拉取全量数据，完全可以把结果缓存起来，只在控件加载时查一次，之后直接用缓存做过滤。
4. UI操作遗漏：你的addItem方法创建了TextBlock，但没把它添加到resultStack里，所以之前就算查询成功也看不到结果。

修复后的完整代码 #

Code Behind

public partial class UserControlQueryDB : UserControl
{
    private readonly IDriver _neo4jDriver;
    private List<string> _cachedSuggestions; // 缓存全量Person姓名，避免重复查库

    public UserControlQueryDB()
    {
        InitializeComponent();
        // 仅初始化一次Neo4j Driver（线程安全，可全局复用）
        _neo4jDriver = GraphDatabase.Driver("bolt://localhost:7687", AuthTokens.Basic("neo4j", "neo4j"));
        // 异步加载数据，不阻塞UI初始化
        _ = LoadSuggestionsAsync();
    }

    private async Task LoadSuggestionsAsync()
    {
        _cachedSuggestions = await GetSuggestionsFromNeoAsync();
    }

    private async Task<List<string>> GetSuggestionsFromNeoAsync()
    {
        using var session = _neo4jDriver.AsyncSession(o => o.WithDatabase("neo4j"));
        // 给查询结果加别名，避免键名匹配问题
        var query = "MATCH (n:Person) RETURN n.Name AS personName";
        var cursor = await session.RunAsync(query);
        // 从查询结果中提取姓名列表
        var nameList = await cursor.ToListAsync(record => record["personName"].As<string>());
        await cursor.ConsumeAsync();
        return nameList;
    }

    // 将事件处理程序改为async void（仅事件场景允许用async void）
    private async void TextBox_KeyUp(object sender, KeyEventArgs e)
    {
        var textBox = sender as TextBox;
        if (textBox == null) return;

        var border = (resultStack.Parent as ScrollViewer).Parent as Border;
        string inputText = textBox.Text.Trim();

        // 先清空结果面板
        resultStack.Children.Clear();

        if (string.IsNullOrEmpty(inputText))
        {
            border.Visibility = Visibility.Collapsed;
            return;
        }

        border.Visibility = Visibility.Visible;
        bool hasMatch = false;

        // 若缓存未加载完成，先显示加载提示
        if (_cachedSuggestions == null)
        {
            resultStack.Children.Add(new TextBlock() { Text = "加载中..." });
            await LoadSuggestionsAsync();
            resultStack.Children.Clear();
        }

        // 用缓存数据做模糊匹配（不区分大小写）
        foreach (var name in _cachedSuggestions)
        {
            if (name.IndexOf(inputText, StringComparison.OrdinalIgnoreCase) >= 0)
            {
                addItem(name);
                hasMatch = true;
            }
        }

        if (!hasMatch)
        {
            resultStack.Children.Add(new TextBlock() { Text = "未找到匹配结果" });
        }
    }

    private void addItem(string text)
    {
        TextBlock block = new TextBlock();
        block.Text = text;
        block.Margin = new Thickness(2, 3, 2, 3);
        block.Cursor = Cursors.Hand;

        // 点击选中后填充到TextBox并隐藏结果面板
        block.MouseLeftButtonUp += (sender, e) =>
        {
            textBox.Text = (sender as TextBlock).Text;
            var border = (resultStack.Parent as ScrollViewer).Parent as Border;
            border.Visibility = Visibility.Collapsed;
        };

        // 鼠标悬停样式
        block.MouseEnter += (sender, e) =>
        {
            if (sender is TextBlock b)
                b.Background = Brushes.PeachPuff;
        };

        block.MouseLeave += (sender, e) =>
        {
            if (sender is TextBlock b)
                b.Background = Brushes.Transparent;
        };

        // 关键：把创建好的TextBlock添加到结果面板里
        resultStack.Children.Add(block);
    }

    // 控件卸载时关闭Driver，释放数据库资源
    protected override void OnUnloaded(RoutedEventArgs e)
    {
        base.OnUnloaded(e);
        _neo4jDriver?.CloseAsync().Wait();
    }
}

XAML（仅微调初始可见性）

<StackPanel Orientation="Horizontal">
    <TextBox Width="300" Padding="5, 3, 5, 3" KeyUp="TextBox_KeyUp" Name="textBox" />
    <Border Width="298" Height="150" BorderBrush="Black" BorderThickness="1" Visibility="Collapsed">
        <ScrollViewer VerticalScrollBarVisibility="Auto">
            <StackPanel Name="resultStack"></StackPanel>
        </ScrollViewer>
    </Border>
</StackPanel>

关键修改点说明 #

1. 复用Neo4j Driver：在构造函数中仅初始化一次Driver，控件销毁时再关闭，避免重复创建昂贵的数据库连接资源。
2. 缓存查询结果：只在控件加载时拉取一次全量数据，后续直接用缓存做过滤，大幅提升响应速度。
3. 修复异步死锁：将TextBox_KeyUp改为async void，用await替代.Result，彻底避免UI线程阻塞。
4. 修正查询键名：给查询结果加别名personName，确保能正确从Record中提取数据（原代码的record["name"]会找不到值）。
5. 补全UI操作：在addItem中添加resultStack.Children.Add(block)，让创建的TextBlock能显示在界面上。

这些修改应该能彻底解决你的应用冻结问题，同时让自动补全功能流畅运行。

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