【Ids4实战】最全的 v4 版本升级指南

上边我们仅仅是更新了Ids4的核心库，我想象着官方既然更新了核心库，那他们的模板库已经也已经更新了，然后就卸载了这几个模板，又重新安装了一次：

其实官方的源码很多也都还是3x版本的，毕竟模板都是这样，直接用文件查找的方式，一一的点开来看，最终还是找到了：

其实大家根据上边的报错一一修改就行了，我这里简单的列举下，心里有个谱。

本次升级到4x，数据库发生了变化，除了增加表以外，比如增加了IdentityResourceClaims表，然后也针对几个表，增删修改了几列字段，具体的我在下文会列举出来，自己更新的时候也可以看到，

所以我们就需要重新生成迁移报告和update数据库了，大家做好生产数据的备份和保护。

如果你不更新数据库迁移的话，肯定会遇到这个错误的：

除了修改了数据库表结构，也同时配套了几个数据库脚本，方便我们使用，具体的查看官方源码即可，基本的更新内容这些：

迁移到ConfigurationDbContext的新模式需要做以下更改:

添加列：Clients、ApiResources、apiscope和ApiScopeClaims
移除列：ApiScopeClaims和ApiScope
重命名表：ApiClaims、ApiProperties、ApiSecrets、IdentityClaims和IdentityProperties
添加表:添加两个新表——ApiResourceScopes和ApiResourceProperties

有关新的范围和资源建模的更多细节，请参考IdentityServer4文档。

迁移到PersistedGrantDbContext的新模式需要做以下更改:
新列:为DeviceCodes和PersistedGrants添加列

为了使转换更容易，我们创建了几个脚本，涵盖四种不同的数据库类型:
MySQL
MsSQL
PostgreSQL
SQLite

可以看到这次升级，只是Ids4相关的组件库，并没有涉及到微软的Identity类库七个用户相关的表，所以用户数据不会丢失。也不用迁移用户数据。

PS:迁移的时候，如果是用我的项目，手动执行下那四个命令，不过相信每个玩过efcore的都明白如何操作：

1、PM> add-migration InitialIdentityServerPersistedGrantDbMigration -c PersistedGrantDbContext -o Data/Migrations/IdentityServer/PersistedGrantDb 2、PM> update-database -c PersistedGrantDbContext3、PM> add-migration InitialIdentityServerConfigurationDbMigration -c ConfigurationDbContext -o Data/Migrations/IdentityServer/ConfigurationDb4、PM> update-database -c ConfigurationDbContext
// 因为不用迁移用户数据，所以不用管用户上下文

整个过程没有报错，虽然它提示说可能造成数据丢失，但是并没有

很流畅的就下来了，只是最后有一个小插曲，就是迁移好后，然后重新生成了容器镜像等，前端admin项目访问的时候，提示没有scope,后来发现Enabled为false了，不知什么时候被改了，修改为true就行了。

除了这个小插曲，文末的问题才是最重要的，但是也是很简单的，不要慌，往下看就是了。

既然我们的数据库表结构都变了，那控制器的一些API和视频模型肯定也会有变化的，这是肯定的，具体我就不好列举了，涵盖以下几个部分：

AccountController、ConsentController、DeviceController、GrantsController、这四部分。

其实不要感觉更新的内容很多，都是很简单的几处，自己稍微看一看，或者用上边官方源代码覆盖下就好了。

理所应当的，视图模型变了，那我们的页面也需要调整：

就是这么多，对应修改下就行了。

整个过程大概持续了30~60分钟，全程并没有很难受的地方，都是粘贴复制啥的。只要心静就可快速搞定。

更新完成以后，可以看到项目已经没有问题了，但是这个时候还会剩下一个小知识点，看startup.cs就知道了。

如果你之前用过Ids4，肯定都知道那个梗，就是本地开发的时候一切正常，如果配置到服务器，源地址一直是localhost域名，之前我也写过一篇文章来讲如何处理这个问题，主要就是用到的是上边截图中，配置PublicOrigin这个属性即可，但是这次在4x版本中，这个api被删掉了。

如果你不做配置的话，会看到这个情况：

找了很多资料，最后还是在官方开源项目的Issue中发现了，看来还是得多看Issue，可能官方也发现3x升级4x有很多问题，干脆直接Pinned了一个issue：

最终的解决方案其实有两种，第一种很简单，直接在中间件的最外层，也就是最上边，添加配置：

 app.Use(async (ctx, next) => {     ctx.SetIdentityServerOrigin("https://xxx.com");     await next(); });

其实就是SetIdentityServerOrigin方法。

第二种就稍微复杂了些，需要三步：

配置服务：

services.Configure<ForwardedHeadersOptions>(options =>{    options.ForwardedHeaders =        ForwardedHeaders.XForwardedFor | ForwardedHeaders.XForwardedProto | ForwardedHeaders.XForwardedHost;    options.KnownNetworks.Clear();    options.KnownProxies.Clear();});

配置中间件：

app.UseForwardedHeaders();

配置Nginx：

proxy_set_header X-Forwarded-Host $host:$proxy_port;