解决2sxc(v20.0.8) AppCode HotBuild编译错误：未生成AppCode.dll

报错信息 #

Error: System.Exception: Error in phase 'final': Can't compile 'AppCode.dll' in AppCode. Details are logged into insights. Could not load file or assembly 'file:///C:\home\site\wwwroot\App_Data\2sxc.bin\App-00052-AppCode.staging-f531f621aa5fdfc387d04173000bdb2758e3e179056447d6b12f363c8785bd3b.dll' or one of its dependencies. The system cannot find the file specified.
at ToSic.Sxc.Code.Sys.HotBuild.AppCodeLoader.TryBuildAppCodeAndLog(HotBuildSpec spec) in C:\Projects\2sxc\2sxc\Src\Sxc\ToSic.Sxc.Code.HotBuild\Code.Sys.HotBuild\AppCodeLoader.cs:line 89

可能原因与排查步骤 #

1. 文件系统权限不足 #

• 检查Azure App Service身份对C:\home\site\wwwroot\App_Data\2sxc.bin目录的读写权限：
  • 登录Azure门户，进入目标App Service，在配置 > 常规设置中确认应用服务身份的权限范围
  • 通过Kudu控制台（https://<你的应用名称>.scm.azurewebsites.net/）查看App_Data\2sxc.bin目录权限，确保应用池身份拥有修改、写入、读取权限
  • 手动在Kudu中创建测试文件，验证目录可写性

2. 临时文件生成受阻 #

• 检查Azure资源限制与安全拦截：
  • 确认App Service临时存储配额未耗尽（在Azure门户的App Service > 用量中查看）
  • 排查是否有Azure安全规则或第三方防火墙拦截了2sxc的临时DLL生成操作
  • 查看2sxc Insights日志（DNN后台2sxc管理界面 > Insights），获取编译阶段的详细错误（报错提示中明确提到日志已记录到Insights）

3. 依赖项缺失或版本不兼容 #

• 验证编译所需的.NET依赖：
  • 确认DNN 10.01.01依赖的.NET框架版本（DNN 10基于.NET 4.7.2）与2sxc v20.0.8的要求匹配
  • 检查网站bin目录下的2sxc核心程序集是否完整，无损坏或版本不一致情况
  • 确认编译所需的NuGet依赖包已完整部署到服务器

4. 2sxc HotBuild配置异常 #

• 检查应用级HotBuild设置：
  • 在DNN后台进入对应2sxc应用的设置 > 代码页面，确认HotBuild功能已启用且编译模式配置正确
  • 清空App_Data\2sxc.bin目录下的所有临时文件，修改视图文件后刷新页面重新触发HotBuild
  • 确认报错中App-00052对应的应用目录结构完整，AppCode文件夹及必要代码文件未缺失

5. Azure App Service沙箱限制 #

• 验证沙箱环境对动态编译的支持：
  • 若当前使用免费/共享层级App Service，尝试切换到基本/标准层级（该层级对动态编译操作限制更少）
  • 检查App Service配置中的应用设置，确认运行时编译相关配置未限制编译操作

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