升级Piranha至10.1后管理器所有保存/POST请求返回400错误如何解决

这是Piranha CMS 10.x版本适配.NET 6时的已知兼容性问题，触发原因有两点：

1. .NET 6默认开启了隐式防伪令牌校验，对所有未显式配置防伪特性的POST端点自动执行校验，校验不通过直接返回400状态码
2. Piranha 10.0-10.1版本的管理器后台接口未对所有POST端点做防伪规则的显式标注，从9.x版本升级时如果保留了旧版本自定义的防伪配置（比如自定义Cookie名、请求头名），就会出现令牌匹配失败，所有POST请求被拦截的情况

按以下步骤操作即可解决：

• 检查服务注册代码，确保调用Piranha服务时已正确注册管理器模块，不要遗漏UseManager()配置，.NET 6顶级语句写法参考如下：

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddPiranha(options =>
{
    options.UseCms();
    options.UseManager(); // 9.x升10.x极易遗漏的必填配置
    // 原有配置如UseSqlServer、UseFileStorage、UseIdentity等保持不变
});

• 移除所有自定义的防伪Cookie名、请求头名配置，Piranha 10.x使用默认的防伪令牌标识，自定义名称会导致前端传递的令牌无法被后端识别。同时关闭.NET 6默认的隐式非空引用类型校验，避免参数绑定阶段触发400错误：

builder.Services.AddControllersWithViews(mvcOpts =>
{
    mvcOpts.SuppressImplicitRequiredAttributeForNonNullableReferenceTypes = true;
});

• 清理浏览器端站点缓存，删除旧版本残留的Cookie、LocalStorage数据，旧的防伪令牌缓存会导致新的校验逻辑匹配失败。

如果完成以上配置后仍存在问题，可直接将Piranha升级到10.2及以上小版本，官方已在后续补丁中修复了管理器端点的防伪标注问题，升级后无需额外配置即可正常运行。不要通过全局关闭防伪校验的方式绕过问题，会给后台引入跨站请求伪造安全风险。

报错参考截图 #

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