如何在Azure API Management策略表达式中添加邮箱正则验证？

完全可以在Azure APIM中实现邮箱格式的正则验证，APIM的策略系统支持通过内置验证策略或自定义表达式逻辑完成这项需求，以下是两种常用实现方式：

1. 使用内置验证策略快速配置 #

通过validate-headers（验证请求头）或validate-content（验证请求体内容）策略，直接指定正则规则即可完成验证，不符合格式时APIM会自动返回400错误。

比如验证请求头X-User-Email的邮箱格式：

<validate-headers specified-headers-only="true">
    <header name="X-User-Email" exists="true">
        <validate-regex pattern="^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$" />
    </header>
</validate-headers>

如果需要验证JSON请求体中的userEmail字段：

<validate-content unspecified-content-type-action="prevent" max-size="1024">
    <content-type value="application/json">
        <validate-json-schema schema="{}">
            <property name="userEmail">
                <validate-regex pattern="^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$" />
            </property>
        </validate-json-schema>
    </content-type>
</validate-content>

2. 自定义逻辑处理（灵活控制响应） #

如果需要自定义错误消息、分支逻辑等，可结合choose策略与.NET正则表达式方法Regex.IsMatch实现：

<choose>
    <when condition="@(!Regex.IsMatch(context.Request.Headers.GetValueOrDefault("X-User-Email", ""), @"^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$"))">
        <return-response>
            <set-status code="400" reason="Bad Request" />
            <set-body>{"error": "请求头X-User-Email的邮箱格式无效"}</set-body>
            <set-header name="Content-Type" exists-action="override">
                <value>application/json</value>
            </set-header>
        </return-response>
    </when>
</choose>

补充说明 #

• 上述正则表达式是通用邮箱格式匹配规则，可根据业务需求调整（比如支持.co.uk这类多级后缀、限制用户名特殊字符等）。
• APIM策略表达式基于.NET框架，所有.NET兼容的正则语法都可直接使用。

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