网站迁移纪实：从Web Form 到 Asp.Net Core （Abp vNext 自定义开发）

问题和需求

从2004年上线，ZLDNN.COM运行已经超过16年了，一直使用DotNetNuke平台（现在叫DNN Platform），从最初的DotNetNuke 2.1到现在使用的7.4。先是在亦庄的独立服务器托管，后来迁到美国的PowerDNN的云服务器ECS，再后来迁移到阿里云的ECS,采用Windows 2008系统，运行几年以后，C盘已经满了，可又没有办法清理，网站速度越来越慢，干脆长痛不如短痛，彻底更新一下。

DotNetNuke严重依赖Web Form技术，其开发团队到现在也没有找到从.Net Framework迁移到.Net Core以及最新的.Net 5或.Net 6的合适技术路线，导致其只能在Windows下运行。另外一个问题是DotNetNuke只能使用SqlServer数据库，无法使用更便宜更灵活的数据库。网站的迁移实际上是在满足现有基本功能的前提下，采用新的技术重新开发。在选择新的技术之前，首先需要梳理一下网站的功能，确定哪些需要保留，哪些可以通过其它方式替代，哪些可以暂时不实现。网站需要保留的部分包括：

• 数据：包括用户数据、订单数据、技术支持数据等。
• 网站页面的Url: 大部分Url已经是SEO友好，但有些页面仍然采用web form模式，比如GetLicense.aspx，这部分Url也需要保留。
• 关键功能：诸如订单接收、产品激活等。

其它的需求还有，希望网站可以运行在维护成本比较低的轻量级应用服务器中，可以采用MySql等开源数据库，视觉效果上尽量与原有系统相同等等。还要留有用户管理已经用户注册的接口。

在大的技术路线上，仍然采用.Net体系，研究了几种技术，包括Qutane、Orchard等，最后决定采用Abp vNext进行开发。

开发

将开发中遇到的具体问题和最终的解决方案总结一下。

外观

采用ABP自带的Theme，根据现有网站的风格进行修改，保持风格大体一致。修改的办法是从Abp源码中复制Theme相关文件到自定义项目对应的目录中，直接修改就可以了。需要修改的文件如下图：



网站的颜色等需要修改文件global-styles.css：

首页

DotNetNuke完全采用动态页面，原来的首页采用的是HTML模块加上DNNArticle的子模块，考虑到首页的更新频率不高，这次采用静态页面。

维护页面

这部分主要是产品、版本、订单等等的维护，属于标准的CRUD界面。这部分采用ABP的标准化设计，首先设计各个实体，然后使用AbpHelper.Gui和AbpHelper.CLI生成相关代码和界面。所生成的界面基本可以使用，需要改造的地方是增加查询功能和调整权限。这里简单介绍一下如何增加查询功能。

ABP MVC/Razor Page 模板生成的基于DataTables.Net的页面支持分页和排序，但缺省情况下不支持查询，需要根据实际情况自行添加。我们可以利用DataTables.Net自带的查询功能实现查询。

首先修改Application项目，增加带有查询的Application服务。先在PagedAndSortedResultRequestDto基础上定义带有关键字的Dto：

    public class OrderNotificationSearchDto: PagedAndSortedResultRequestDto
    {
        public string Key { get; set; }
    }

然后在Application 服务中增加查询服务：

        public async Task<PagedResultDto<OrderNotificationDto>> GetSearchListAsync(OrderNotificationSearchDto input)
        {
            var query = await CreateFilteredQueryAsync(input);
            if (!string.IsNullOrEmpty(input.Key))
            {
                query = query.Where(o => o.InvoiceID.Contains(input.Key)
                || o.OptionName.Contains(input.Key)
                || o.PackageName.Contains(input.Key)
                || o.BillToEmail.Contains(input.Key));
            }
            var totalCount = await AsyncExecuter.CountAsync(query);
            query = ApplySorting(query, input);
            query = ApplyPaging(query, input);
            var entities = await AsyncExecuter.ToListAsync(query);
            var entityDtos = await MapToGetListOutputDtosAsync(entities);
            return new PagedResultDto<OrderNotificationDto>(
                totalCount,
                entityDtos
            );
        }

然后需要改造客户端，首先将index.js中datatables的设置searching改为true：

   var dataTable = $('#OrderNotificationTable').DataTable(abp.libs.datatables.normalizeConfiguration({
        processing: true,
        serverSide: true,
        paging: true,
        searching: true,

接下来修改ajax的定义：

//ajax: abp.libs.datatables.createAjax(service.getList),
        ajax: abp.libs.datatables.createAjax(service.getSearchList, inputAction, responseCallback),

将getList修改为新的getSearchList，增加新的传入参数和Callback。这两个函数定义如下：

   var inputAction = function (requestData, dataTableSettings) {
        var ctl = $("#OrderNotificationTable_filter input").val();
        return {
            key: ctl,
        };
    };
    var responseCallback = function (result) {
        // your custom code.
        return {
            recordsTotal: result.totalCount,
            recordsFiltered: result.totalCount,
            data: result.items
        };
    };

网站数据的导入

这部分主要包括产品数据和与激活相关的数据，采用自己写的一个面向.Net Core的ADO库，将原有的数据导出到Xml中，在新的应用中从Xml中读取数据进行初始化。

产品内容页

产品的内容原来保持在数据库中，现在改为在文件中保存，加载产品页时，从文件读出展示。

外部数据交换

主要包括接收从DNNStore发来的数据和产品激活两部分。采用Application Service实现，通过Apb框架的动态Web Api可以访问。

Url重定位

包括与外界交换数据的Url和为了保证SEO一致的界面Url。采用.Net Core的ReWrite中间件实现，感觉这部分真的很好用。代码如下：

            var options = new RewriteOptions()
            .AddRewrite(@"^GetLicense.aspx", "Products/Services/ManualActivate",true)
            .AddRewrite(@"^Products/currentpage/(\d+)", "Products?currentpage=$1", true)
            .AddRewrite(@"^ProductDetail/(.+)", "Products/ViewDetail?name=$1", true)
            .AddRewrite(@"^LicenseCode.aspx", "api/app/activate/req-license-code", true)
            .AddRewrite(@"^desktopmodules/OrderNotification/OrderNotify.aspx", "api/app/activate/save-order", true)
             app.UseRewriter(options);

还有其它一些细节包括关闭多租户、关闭用户注册、国际化修改等等。

从十一前开始，断断续续开发了两到三周的时间。

部署和运行

以前一直在Windows生态中，部署应用似乎不是大问题，只有在IIS上创建网站或者应用就可以了。现在希望将ZLDNN.COM迁移到阿里云的轻量级服务器，在Linux系统下部署，还是遇到一些挑战。

首先解决.Net Core应用在Linux上运行的问题。由于在生产环境中只运行一个.Net Core应用，所以在生成部署文件时采用独立运行模式，这样就不需要在生产环境中安装.Net框架。这一步没有遇到大问题，测试应用能够运行。

然后是ABP应用在生产环境上运行，这里遇到一个问题，Couldn’t find a valid ICU package installed on the system.这个问题在本地测试没有遇到，查了一下是没有安装ICU库，安装完成后问题解决了。

数据库的配置没有遇到太大麻烦，但在后期运行时出现了MySql异常退出的问题，发现是内存问题，创建内存交换文件后解决了。

Apache服务器配置花了一些时间，因为两个域名驻留在同一个服务器上，需要将Apache服务器配置为反向代理服务器，由于对Apache服务器不熟悉，折腾了一些时间，不过最后也成功了。

到现在新网站运行了两个多月，基本没有遇到太大的问题。效果还是不错的，速度提升很多。