DNN 9.8站点升级后HTML模块仅在编辑模式显示求助

核心根因优先级排查 #

• 优先验证内容工作流状态：DNN 9.8版本对HTML模块新增了内容状态拆分逻辑，升级场景下极易出现新建内容自动标记为草稿、未触发正式发布流程的问题。该状态下内容仅对拥有编辑权限的用户展示，普通访客视角会因匹配不到正式发布的内容直接跳过模块渲染，全程不会抛出任何前后端错误。
  快速验证方式：找到任意出问题的HTML模块，在编辑界面不要直接点「保存」，而是点击保存按钮旁的下拉选项，选择「提交并发布」，退出编辑模式查看模块是否正常显示。
• 版本提示的误区澄清：当前后台标注的HTML模块可升级到10.0.3版本，是DNN后续核心迭代时将HTML模块从核心包拆为独立分发包的版本号，该版本与当前运行的9.8.0核心存在版本依赖差，不能直接安装升级，版本提示不是当前故障的触发原因，强行升级反而会引发核心组件校验异常。

已排查项的补充校验 #

• 权限层级的漏项排查：不要仅校验模块本身的查看权限，需要检查模块关联内容条目级别的独立权限。DNN 9.8开始对独立内容条目配置了独立的权限继承规则，就算模块本身开放所有用户可见，底层关联的内容条目如果默认仅分配给编辑角色查看，仍会出现非编辑视角不渲染的问题。该配置入口在模块的「内容设置-高级设置-内容权限」中，不在常规模块权限弹窗内。
• 缓存规则的漏项排查：除了将单模块缓存设为0，需要临时关闭站点级的页面输出缓存、内容缓存全量规则。升级场景下旧版本的缓存匹配规则会和新版本的模块渲染逻辑不兼容，导致新插入的HTML模块内容因规则不匹配被直接过滤，操作完成后手动触发全站点缓存硬刷新再测试。
• 自定义渲染逻辑的排查：临时切换到DNN默认官方皮肤，重新新增一个HTML模块验证是否正常显示。如果切换后模块可正常展示，说明当前自定义皮肤/全局脚本存在DOM过滤逻辑：旧版自定义皮肤通常会加载脚本过滤空内容模块，但9.8版本的HTML模块在非编辑模式下的DOM渲染时机晚于旧版本，会被脚本误判为空模块直接移除。

兜底修复操作 #

• 重置HTML模块绑定的工作流：进入站点「设置-内容设置-工作流」，找到绑定到HTML模块的默认工作流配置，临时将规则调整为「无工作流，保存内容即自动发布」，保存配置后重新测试新增HTML模块的非编辑态展示效果。
• 修复升级遗留的模块定义配置：进入主机管理的「模块定义」页面，找到HTML模块的定义项，重置对应「查看视图」的默认权限校验配置，修复升级残留的权限判断逻辑错乱问题——这类错乱会让系统在非编辑视角下错误判断为无加载权限，直接跳过模块渲染且不抛出错误。

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