Umbraco项目VS2019 FTP发布与文件夹发布后FTP工具上传异常咨询

Umbraco手动FTP部署异常的常见原因 #

• FTP传输模式不匹配：普通FTP客户端默认可能使用ASCII模式传输文件，Umbraco项目中的dll程序集、App_Data下的序列化文件、图片字体等静态资源都属于二进制文件，ASCII模式会篡改这类文件的内容导致损坏。VS自带的FTP发布功能会自动识别文件类型选择对应传输模式，不会出现该问题。可将FTP客户端的传输模式修改为二进制/自动识别模式后重新传输验证。
• 服务器端文件权限缺失：Umbraco运行要求App_Data、umbraco、umbraco_client、Views、wwwroot（仅Umbraco Core版本）等目录具备IIS运行用户的读写权限。VS发布过程会自动同步远程站点的权限配置，手动通过FTP传输文件不会修改服务器端的权限配置，会出现站点读写必要文件失败的问题。可在服务器端给上述目录授予IUSR、对应应用程序池身份的读写权限验证。
• 文件传输不完整或版本冲突：Umbraco存在大量零碎小文件，传输过程中网络波动、服务器超时都可能导致部分文件丢失、传输不全。如果服务器上留存有旧版本部署文件，手动传输未完全覆盖旧文件时，新旧版本的程序集、配置文件冲突也会导致站点异常。可先清空服务器站点根目录所有文件，全量重新传输后核对本地发布目录和服务器端的文件数量、总大小是否一致。
• 环境配置不匹配：VS自带的发布功能支持配置文件转换，会自动将Web.config/appsettings.json中的本地配置（比如数据库连接字符串、缓存配置、路径配置）替换为适配远程服务器的配置。手动传输本地发布的文件时，会直接使用适配本地IIS的配置，和服务器环境不兼容导致站点无法正常运行。可对比服务器上历史正常运行的配置文件，修改对应参数适配服务器环境。
• 应用程序池未重启：VS发布完成后会自动触发远程站点的应用程序池重启，加载新的程序集和配置。手动传输文件完成后IIS不会自动重启应用池，内存中仍加载旧版本的程序文件，会出现功能部分异常的问题。可传输完成后手动重启对应站点的应用程序池验证。

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