WebChat中UserProfile获取为null，Emulator与DirectLine正常问题排查

这个问题的核心是WebChat中用户标识的稳定性问题，结合Bot Framework的State存储逻辑导致的：

1. 核心原因：WebChat默认用户ID不持久化 #

Bot Framework的UserState是基于用户的唯一ID来绑定存储数据的。在WebChat中，如果你没有明确指定固定的user.id，WebChat会自动生成一个随机临时ID——每次刷新页面或重新打开会话时，这个ID都会改变。这就导致之前存储的UserProfile无法匹配新会话的用户ID，自然返回null。而ConversationData绑定的是会话ID，只要会话未结束，数据就能正常读取。

2. 解决方案：给WebChat设置持久化的用户ID #

修改你的WebChat客户端代码，为用户生成并存储一个固定ID（比如借助localStorage），确保每次页面加载时用户ID一致：

// 从本地存储获取或生成固定用户ID
let userId = localStorage.getItem('webchat_user_id');
if (!userId) {
  // 生成唯一且稳定的用户ID
  userId = 'webchat_user_' + Math.random().toString(36).substring(2, 12);
  localStorage.setItem('webchat_user_id', userId);
}

// 明确设置用户对象的id和name
const user = { id: userId, name: 'WebChat User' };

const res = await fetch('https://directline.botframework.com/v3/directline/conversations', {
  method: 'POST',
  headers: { "Authorization": "Bearer mySecretKey" },
});
const { token } = await res.json();
const dl = window.WebChat.createDirectLine({ token });

window.WebChat.renderWebChat({
  directLine: dl,
  user: user,
}, document.getElementById('webchat'));
document.querySelector('#webchat > *').focus();

3. 额外检查：确保State数据正确保存 #

另外，检查Bot代码中是否在设置UserProfile后调用了SaveChangesAsync——虽然Bot Framework默认会在回合结束时自动保存State，但在Dialog的OnStartAsync中手动触发保存可以避免潜在的时序问题：

protected override async Task OnStartAsync(DialogContext dc, CancellationToken cancellationToken = default)
{
    var context = dc.Context;

    // 设置状态数据
    await _accessors.ConversationDataAccessor.SetAsync(context, new ConversationData(dc.Context.Activity.ChannelId));
    await _accessors.UserProfileAccessor.SetAsync(context, new UserProfile("Elena"));

    // 手动保存State变更
    await _accessors.UserState.SaveChangesAsync(context, cancellationToken: cancellationToken);
    await _accessors.ConversationState.SaveChangesAsync(context, cancellationToken: cancellationToken);

    await dc.Context.SendActivityAsync($"ConversationData and UserProfile were set in MainDialog.OnStartAsync()");
    
    var reply = context.Activity.CreateReply();
    reply.Text = "Say 'print out state' or click the button.";
    reply.SuggestedActions = new SuggestedActions() {
        Actions = new List<CardAction>() {
            new CardAction(type: ActionTypes.ImBack, title: "Test State", value: "print out state"),
        }
    };
    await context.SendActivityAsync(reply);
}

4. 修复构造函数的小错误 #

顺便提一下，你的StateBotAccessors构造函数里的异常参数写反了，虽然这不是WebChat的问题，但修正它可以避免后续调试混淆：

public StateBotAccessors(ConversationState conversationState, UserState userState)
{
    ConversationState = conversationState ?? throw new ArgumentNullException(nameof(conversationState));
    UserState = userState ?? throw new ArgumentNullException(nameof(userState));
}

完成以上修改后，WebChat中的UserProfile应该就能像Emulator和DirectLine一样正常持久化了。

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