文件已正常部署且能正常访问到，但点击“文件已部署，立即认证”按钮时，然后被提示：访问文本资源失败，请调整后重试。原因是微信验证请求是 http 协议，如果网站强制启用 https 则无法完成验证。
在 ASP.NET 6 中可打开 Program.cs 文件，临时注释掉下行即可：
app.UseHttpsRedirection();
论坛出现动态页面打开或刷新非常慢（超过半分钟），甚至打不开，该页无法显示，502 Bad Gateway 等情况，TTFB 计时需要好几秒。
切换 nginx 版本、php 版本 等均无效果，甚至购买新的 ECS 重新搭建环境也是效果甚微。
最终在阿里云 RDS 管理中，手动主备库切换，问题得以解决。
因此大概率是原主库有问题（有损坏的表需要修复或锁等情况）。
查询故障时间段的慢 SQL，发现某表的锁等待时间特别长，不知道是不是这个表的原因导致的。
次日，提交工单得到回复是原主库（现备库）会自动修复，经再次主备库切换测试得到了肯定的结果。
再次日，又遇到同样的打开慢的情况，这次直接找到慢 SQL 中锁等待时间较长的表，优化（OPTIMIZE TABLE）（虽然是 InnoDB），立刻解决了问题。
开发环境正常，发布到 IIS 报错
Could not load file or assembly 'Microsoft.EntityFrameworkCore.Relational, Version=6.0.x.0, Culture=neutral, PublicKeyToken=adb9793829ddae60'. 系统找不到指定的文件。
尝试在 UI 层安装 Pomelo.EntityFrameworkCore.MySql 无果。
最终，在发布时文件发布选项中，去掉“启用 ReadyToRun 编译”就正常了。
当然这种情况不是在所有启用了 ReadyToRun 编译的项目中遇到，但该项目改为不启用 ReadyToRun 后恢复正常了，原因暂时未知。
安装 Windows 11 的外星人笔记本电脑，当关闭盖子，或按下电源键，或直接在系统里点击“睡眠”按钮均不能使系统正常睡眠，可能的原因如下：
正在运行 Alienware Mobile Connect
迅雷的“离线模式”开启
注意：当接通电源的电脑关闭盖子，系统会执行睡眠，但当拔下电源线时，又会自动唤醒，可谓奇葩。这一点经过外星人官方确认，外星人机子都是这样的。
另外，当正在睡眠的笔记本电脑插上电源，或打开盖子，或按下电源键，均会唤醒。
因此，正确的睡眠步骤：关闭阻止睡眠的程序，断开电源，关闭盖子。
直接运行项目启动程序（在发布目录中，以项目名称为文件名，扩展名为 .exe 的可执行程序）
启动后可在“Now listening on:”所在行看到访问入口 URL（如图中 http://localhost:5000）。
在同服浏览器中打开该地址，访问到报错页面，回到该命令行窗口可见“fail”异常的详细信息。
今天发现在开发新项目时，微信分享失效了，开启 debug = true 后，在微信开发工具中提示：
{"errMsg":"updateTimelineShareData:fail, the permission value is offline verifying"}
在真机上提示：
{"errMsg":"config:ok"}
{"errMsg":"updateAppMessageShareData:ok"}
{"errMsg":"updateTimelineShareData"}
仍然找不出原因。
尝试打开已上线的项目，分享功能均正常。
偶然发现，当打开使用 JS-SDK 分享后的图文框的页面，能够正常分享，而直接点开链接的页面，没有分享按钮。
这难免不让人联想到最近GJ出的新政，新版微信已经开放淘宝、抖音等平台的链接打开权限，只是当点击链接的时候会出现一个风险提示页面：
而一旦由这个页面进入的网页，分享功能均不能正常。
另外还测试了以下几种情况的分享功能也能正常：
公众号推送的图文或链接、公众号菜单、个人发送到公众号的链接、通过扫一扫打开的页面等。
-- 2021.9
如果你的视图页面（.cshtml）是由另一个视图页面复制而来的，就有可能出现开发调试时正常，发布到服务器后打开报 500 错误。
解决方法是：新建一个 .cshtml 页面，将代码移植到这个文件上，删除原来的页面，更改刚创建的文件名。
你也可以直接修改项目文件将视图页面重新包含到项目中。
本文记录于 2021 年 9 月。
| 升级前 | 期望（最新正式版） | 最终选择 | |
| 操作系统 | CentOS 6.5 | Alibaba Cloud Linux 3 | Alibaba Cloud Linux 3 |
| 管理面板 | lnmp | 宝塔面板 Linux 版 7.7.0 | 宝塔面板 Linux 版 7.7.0 |
| Web 服务 | nginx 1.6 | nginx 1.21 | nginx 1.21 |
| 脚本语言 | PHP 5.6 | PHP 8.0 | PHP 7.4 |
| 数据库 | RDS MySQL 5.6 | RDS MySQL 8.0 | RDS MySQL 5.6 |
| 论坛程序 | Discuz! X3.2 GBK | Discuz! X3.5 UTF-8（即将发布） | Discuz! X3.4 GBK |
版本选择原因：
Alibaba Cloud Linux 完全兼容 CentOS，相比于 CentOS 较短的生命周期，Alibaba Cloud Linux 3 将于 2029 年 4 月 30 日结束生命周期。
Discuz! X3.4 不支持 PHP 8.0，安装时即报错，打开页面时一片空白。
MySQL 8.0 和阿里云 RDS 的 MySQL 7.5 不支持 MyISAM，而数据表 pre_common_member_grouppm 和 pre_forum_post 使用联合主键且自动递增字段不是第一主键，使用 InnoDB 引擎创建表时会报“1075 - Incorrect table definition; there can be only one auto column and it must be defined as a key”错误，而擅自更改主键次序会影响业务逻辑。因此，在必须选择阿里云 RDS 的情况下，只能选择 MySQL 5.6。（2023年8月注：查看如何更改为 InnoDB）
Discuz! X3.5 正式版尚未发布（截止发稿），即便发布，插件也可能不能得到及时更新。相比之下，X3.4 首个版本发布距今已有 4 年，相关第三方插件已经非常成熟。
完整升级步骤：
备份原网站程序、RDS 数据库；
购买新的 ECS、RDS，挂载磁盘，安装云监控；
迁移（或还原）数据库到新的 RDS；
安装宝塔面板并配置；
安装 nginx 及 PHP；
创建网站、配置 SSL、伪静态、防盗链、可写目录禁执行等（.conf）；
配置 hosts；
上传原网站程序到新的站点目录下；
按 Discuz! X 升级文档升级 X3.2 至 X3.4；详情见下文 ↓；
配置 OSS、Redis、更新缓存等；
测试论坛基本功能是否正常；检查附件是否正常显示；全面检查控制台配置；
逐个开启插件并检查兼容性；
按二开备忘录逐个按需进行二开；
逐个修改调用论坛接口的项目及直接调用论坛数据库的项目；
调试 MAGAPP 接口；
尝试强制 https 访问；
将以上所有修改后的程序保留备份；发布升级公告并关闭论坛；重复以上步骤；修改域名解析；开启论坛；
配置 IP 封禁、定时器、日志、自动备份、配置其它 ECS 的 hosts 等；
查看搜索引擎中收录的地址，是否有无法访问的情况；
尝试将历史遗留的本地附件全部转移到 OSS；
参这篇文章，可能有其它需要配置的地方。
Discuz! X 升级步骤及注意点：
升级前务必先修改 ./config/ 目录下的数据库/缓存连接信息，以防出现新站连接老库的情况；
按官方文档进行升级；
【问题】运行到 ./install/update.php?step=data&op=notification 时白屏。
【排查】尝试切换到 PHP 5.6 后成功（但该版本过于陈旧不能使用）；尝试升级 CPU 和内存 PHP 7.4 上升级仍不成功。
【原因】DB::result_first() 方法不对 SQL 语句追加“limit 1”，而是 SELECT 所有记录后在 PHP 端取第一条数据；
【解决】打开文件 update.php，查找 elseif($_GET['op'] == 'notification')，该节点的功能是在表 home_notification 中查找 category <= 0 的数据并修复它，如果数据库中所有 category 都大于 0，直接注释其内部 if 代码段继续升级即可（或改为 if(false && ...)）。
【问题】发布主题遇到错误：(1062) Duplicate entry '*' for key 'pid'
【原因】forum_post 中的 pid 不是自动增长的，而是由表 forum_post_tableid 中自动增长的 pid 生成的。如果生成的 pid 值已在 forum_post 表中存在，则会出现此错误。
【解决】迁移数据库时应关闭论坛，以防止 forum_post 表有新数据插入。
【问题】打开帖子页面 ./thread-***-1-1.html 显示 404 Not Found，而 ./forum.php?mod=viewthread&tid=*** 可以正常打开
【原因】未配置伪静态（可在宝塔面板中选择）
【问题】打开 UCenter 时报错：UCenter info: MySQL Query Error SQL:SELECT value FROM [Table]vars WHERE name='noteexists'
【解决】打开文件 ./uc_server/data/config.inc.php 配置数据库连接
【问题】打开登录 UCenter 后一片空白
【解决】将目录 ./uc_server/data/ 设为可写
需要将原来安装的插件文件移回 ./source/plugin/ 目录，并设置可写；
界面-表情管理，界面-编辑器设置-Discuz!代码
后续 Discuz! X3.4 R 小版本升级注意事项：
确认插件是否支持新版本（如短信通）
先创建一个新网站测试二开代码
保留 /config/、/data/、/uc_client/data/、/uc_server/data/、/source/plugin/，其它移入 old
上传文件
移回其它需要的文件，如：
-- 勋章/loading/logo/nv 等：/static/image/common/
-- 表情：/static/image/smiley/
-- 水印：/static/image/common/watermark.*
-- 风格：/template/default/style/t2/nv.png 等
-- 默认头像：/uc_server/images/noavatar_***.gif
-- 根目录 favicon.ico 等
-- 及其它非 DZ 文件
再次检查可写目录的写入权限和禁止运行 PHP 效果。
1075 - Incorrect table definition; there can be only one auto column and it must be defined as a key
在 MyISAM 转 InnoDB 时出现。
原因：这个表有联合主键，且自增的字段不是第一个主键。
解决方法一，取消自增字段的自动递增，改为在程序中实现；
解决方法二，单独给自增字段单独添加一个索引。
以 Disucz! X3.4 为例，方法一改程序代码显然困难比较大，所以选择方法二。
表 pre_forum_post 中，tid 为第1主键，position 为第2主键且自增。
tid 表示主题，position 表示该帖在该主题中的位置（类似于楼层的概念）。
所以在原来 MyISAM 中可以方便地实现 position 在各自的主题下自增。
给 position 单独添加索引后可以将引擎改为 InnoDB，但是 position 在全表范围内自增了。
也就是说，如果发布一个新主题，那么这个主题帖的 position 就不是1，而是整个数据库中最大的 position 再加 1。
虽然不影响页面中帖子的排序和楼层号显示，但不知道会不会有其它问题，所以最好把它改过来。
给表 pre_forum_post 添加一个触发器，在插入前（BEFORE INSERT）
BEGIN
DECLARE max_position INT;
SELECT MAX(position) INTO max_position FROM pre_forum_post WHERE tid = NEW.tid;
IF max_position IS NULL THEN
SET max_position = 0;
END IF;
SET NEW.position = max_position + 1;
END在上面触发器的定义中，NEW 指即将要插件的一条记录，在新插入的帖子所在主题中寻找最大的 position 赋值给一个 INT 变量，如果找不到就赋值 0，然后 +1 赋值给新的 position。
这样就实现了与原来相同的效果。
用同样的方法给表 pre_common_member_grouppm 添加触发器。
如果帖子有分表，给每个分表添加触发器，下次有新的分表也要记得添加。
