Discord.Net机器人全部失效求助：无报错且命令处理逻辑异常

问题描述 #

所有Discord.Net机器人模块失效，已尝试重启电脑、切换Git旧分支，无任何错误提示。在HandleCommandAsync方法中，程序无法执行if判断后的逻辑，但理论上应该进入该分支。

相关信息 #

• 日志仅输出start Handle，未输出Handle，说明if条件判断未通过
• 日志显示userMessage.HasCharPrefix结果为True，userMessage.HasMentionPrefix结果为False
• 命令模块已被正确加载（模块数量为3）

代码片段 #

public class CommandHandler : ICommandHandler
{
    private readonly DiscordSocketClient _client;
    private readonly CommandService _commands;
    private readonly IServiceProvider _services;
    private readonly ILogger _logger;

    public CommandHandler(DiscordSocketClient client, CommandService commands, IServiceProvider services, ILogger logger)
    {
        _logger = logger;
        _client = client;
        _commands = commands;
        _services = services;
    }

    public async Task InstallCommandsAsync()
    {
        _client.MessageReceived += HandleCommandAsync;
        
        await _commands.AddModulesAsync(Assembly.GetEntryAssembly(), 
            _services);
    }

    private async Task HandleCommandAsync(SocketMessage message)
    {
        if (message is not SocketUserMessage userMessage) return;

        int argPos = 0;

        _logger.LogDebug("start Handle");
        _logger.LogDebug($"userMessage.HasCharPrefix: {!userMessage.HasCharPrefix('!', ref argPos)}");
        _logger.LogDebug($"userMessage.HasMentionPrefix: {userMessage.HasMentionPrefix(_client.CurrentUser, ref argPos)}");

        if (!(userMessage.HasCharPrefix('!', ref argPos) || 
              userMessage.HasMentionPrefix(_client.CurrentUser, ref argPos)) ||
            userMessage.Author.IsBot)
            return;

        _logger.LogDebug("Handle");
        
        var context = new SocketCommandContext(_client, userMessage);

        await _commands.ExecuteAsync(
            context: context, 
            argPos: argPos, 
            services: _services);
    }
}

排查与解决方案 #

1. 修复argPos被重复修改的问题 #

userMessage.HasCharPrefix和userMessage.HasMentionPrefix方法会修改传入的argPos值，你在日志中调用这两个方法时已经改变了argPos的初始值，导致后续if判断时参数异常，无法匹配前缀。

修复代码：复制初始argPos用于日志输出，避免影响判断逻辑：

private async Task HandleCommandAsync(SocketMessage message)
{
    if (message is not SocketUserMessage userMessage) return;

    int argPos = 0;
    // 复制初始argPos用于日志，避免修改判断用的变量
    int logArgPos = 0;

    _logger.LogDebug("start Handle");
    _logger.LogDebug($"userMessage.HasCharPrefix: {userMessage.HasCharPrefix('!', ref logArgPos)}");
    // 重置日志用的argPos，再检查提及前缀
    logArgPos = 0;
    _logger.LogDebug($"userMessage.HasMentionPrefix: {userMessage.HasMentionPrefix(_client.CurrentUser, ref logArgPos)}");

    if (!(userMessage.HasCharPrefix('!', ref argPos) || 
          userMessage.HasMentionPrefix(_client.CurrentUser, ref argPos)) ||
        userMessage.Author.IsBot)
        return;

    _logger.LogDebug("Handle");
    
    var context = new SocketCommandContext(_client, userMessage);

    await _commands.ExecuteAsync(
        context: context, 
        argPos: argPos, 
        services: _services);
}

2. 验证机器人权限 #

确认机器人在目标服务器中拥有读取消息、发送消息的基础权限，且未被服务器的频道权限或自动屏蔽规则限制。

3. 检查消息类型 #

确保发送的是普通用户消息，系统消息（如频道通知、机器人自动回复）会被message is not SocketUserMessage过滤。

4. 确认前缀正确性 #

检查发送命令时使用的前缀是否为半角!，避免输入全角符号或其他错误前缀。

内容的提问来源于stack exchange，提问作者I-Rey