Azure API Management TRACE策略规则消息中变量无法展开问题咨询

问题根因 #

• APIM 策略不支持静态文本与@()表达式混写在同一个策略节点内容中。你最初编写的<message>节点同时包含静态字符串Requesting User: 和@(context.User)表达式，系统会将整段内容识别为普通文本，不会解析表达式部分，因此变量无法展开。
• 你后续测试的策略可以正常运行，正是因为整个<message>节点内容都是被@()包裹的完整表达式，无混写的静态内容，符合APIM策略表达式的语法要求。
• 直接调用@(context.User)无法输出可读的用户信息：context.User是复合对象，直接调用ToString只会输出对象类型名，需要显式读取其下的具体属性（如Id、Email、Name等）才能拿到实际用户数据。

修复方案 #

将静态文本和变量统一放到@()包裹的完整表达式内即可，示例如下：

<policies>
    <inbound>
        <base />
        <trace source="me-apim.azure-api.net" severity="information">
            <!-- 整段内容为完整表达式，用字符串插值拼接静态文本和变量，同时做空值兼容 -->
            <message>@($"Requesting User: {context.User?.Email ?? "未认证用户"}")</message>
        </trace>
    </inbound>
    <backend>
        <forward-request />
    </backend>
    <outbound>
        <base />
    </outbound>
    <on-error>
        <base />
    </on-error>
</policies>

排查实用技巧 #

• 使用VS Code作为APIM调试工具使用体验极佳
• Azure ADO UX内置的代码片段功能对编写策略规则帮助很大

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