技术积累 · 部署
IIS 部署 ASP.NET Core,被两个报错拦了一整天
把一个跑得好好的 ASP.NET Core 应用发布到 IIS 上,先后被 500.38 和 500.30 两个报错拦住。两个错误的根因都不在 IIS 本身,记录下来避免下次再撞。
500.38:单文件发布与 in-process 的矛盾
报错原文写得很直白:Single-file deployments are not supported in IIS。IIS 的 ASP.NET Core 模块(in-process 模式)需要直接加载应用的主 DLL;而单文件发布把主 DLL 嵌进了 exe 内部,模块找不到,只能报 500.38。
解法:去掉 PublishSingleFile,用标准的 self-contained 文件夹形式发布——文件夹里会多出几百个运行时 DLL,但这正是 IIS 想要的样子。单文件留给需要"拷走就跑"的场景(桌面工具),IIS 部署用文件夹。
500.30:迁移历史表的「半成品」状态
应用启动时报 500.30,数据库里检查发现:迁移历史表里写着"表已建过",实际表却不存在——典型的半成品状态,多半来自之前某次部署中断。应用每次启动按历史记录跳过建表,于是业务表一直缺失,启动即抛异常。
解法有两层。短期:在数据库里清掉迁移历史与半成品架构,重启让建表流程重跑。长期:放弃依赖迁移历史的机制,改成启动时执行幂等的建表 SQL——每条语句都带 IF NOT EXISTS,每次启动自动补齐缺失的表,半成品状态被直接修复,不再依赖历史记录的正确性。
一句话总结:IIS 部署用文件夹不用单文件;建表机制选幂等 SQL 不选迁移历史——两条都指向"让状态可以从损坏中自动恢复"。
← AES-GCM 两端配对
最新一篇