GitLab部署应用至Function App报PushDeploymentController创建错误

问题现象 #

• 通过GitLab向Function App发布应用过程中触发部署报错，流水线重复执行当前目录归档、28.06MB包上传操作后，最终返回InternalServerError错误，部署失败。

根因分析 #

从返回的错误堆栈可直接定位核心问题：

内部抛出System.UnauthorizedAccessException异常，提示路径C:\home\LogFiles\kudu\deployment访问被拒绝。
表层返回的"控制器无参数公共构造函数"为误导性报错，实际本质是Kudu部署进程没有部署日志目录的创建、写入权限，导致PushDeploymentController控制器依赖注入失败、无法完成初始化，最终整个部署接口返回500错误。

排查解决步骤 #

按以下优先级依次操作验证，每步完成后重新触发部署测试：

• 重启Function App实例：在云服务商控制台找到对应Function App，执行重启操作，等待实例完全启动后重试。该操作可解决绝大多数临时文件系统锁、进程权限异常问题。
• 校验应用配置项：检查Function App的WEBSITE_RUN_FROM_PACKAGE配置项，若被误设为1会将整个文件系统锁定为只读状态，部署时无法写入任何文件，需将该值改为0或直接删除该配置项，重启实例后重试。
• 重置部署凭据：进入Function App部署中心页面，重置发布账号凭据，将GitLab流水线中配置的部署用户名、密码更新为新生成的有效值后重试。
• 手动清理部署目录：打开Function App对应的Kudu管理控制台，进入命令行调试界面，导航到C:\home\LogFiles\kudu\路径，手动删除已存在的deployment文件夹，或给该路径授予读写权限后重试。
• 检查关联存储状态：确认Function App绑定的底层存储账号无访问限制、访问密钥未过期、账号未被管理员锁定，存储异常会直接导致应用的/home目录无法正常读写。

错误日志（翻译版） #

正在为当前目录创建归档包...
正在上传28.06 MB []正在为当前目录创建归档包...
正在上传28.06 MB []正在为当前目录创建归档包...
正在上传28.06 MB []归档包上传错误（内部服务器错误）。
服务端响应：{"Message":"发生错误。","ExceptionMessage":"创建PushDeploymentController类型控制器时出错，请确保该控制器拥有无参数公共构造函数。","ExceptionType":"System.InvalidOperationException","StackTrace":"   at System.Web.Http.Dispatcher.DefaultHttpControllerActivator.Create(HttpRequestMessage request, HttpControllerDescriptor controllerDescriptor, Type controllerType)\r\n   at System.Web.Http.Controllers.HttpControllerDescriptor.CreateController(HttpRequestMessage request)\r\n   at System.Web.Http.Dispatcher.HttpControllerDispatcher.<SendAsync>d__1.MoveNext()","InnerException":{"Message":"发生错误。","ExceptionMessage":"路径'C:\\home\\LogFiles\\kudu\\deployment'访问被拒绝。","ExceptionType":"System.UnauthorizedAccessException","StackTrace":"   at System.IO.__Error.WinIOError(Int32 errorCode, String maybeFullPath)\r\n   at System.IO.Directory.InternalCreateDirectory(String fullPath, String path, Object dirSecurityObj, Boolean checkHost)\r\n   at System.IO.Directory.InternalCreateDirectoryHelper(String path, Boolean checkHost)\r\n   at System.IO.Directory.CreateDirectory(String path)\r\n   at System.IO.Abstractions.DirectoryWrapper.CreateDirectory(String path)\r\n   at Kudu.Core.Infrastructure.FileSystemHelpers.CreateDirectory(String path) in C:\\Kudu Files\\Private\\src\\master\\Kudu.Core\\Infrastructure\\FileSystemHelpers.cs:line 32\r\n   at Kudu.Core.Environment.get_DeploymentTracePath() in C:\\Kudu Files\\Private\\src\\master\\Kudu.Core\\Environment.cs:line 297\r\n   at Kudu.Services.Web.App_Start.NinjectServices.GetLogger(IEnvironment environment, IKernel kernel) in C:\\Kudu Files\\Private\\src\\master\\Kudu.Services.Web\\App_Start\\NinjectServices.cs:line 775\r\n   at Kudu.Services.Web.App_Start.NinjectServices.<>c__DisplayClass10_0.<RegisterServices>b__13(IContext context) in C:\\Kudu Files\\Private\\src\\master\\Kudu.Services.Web\\App_Start\\NinjectServices.cs:line 280\r\n   at Ninject.Activation.Providers.CallbackProvider`1.CreateInstance(IContext context)\r\n   at Ninject.Activation.Provider`1.Create(IContext context)\r\n   at Ninject.Activation.Context.ResolveInternal(Object scope)\r\n   at Ninject.Activation.Context.Resolve()\r\n   at Ninject.KernelBase.<>c__DisplayClass15.<Resolve>b__f(IBinding binding)\r\n   at System.Linq.Enumerable.WhereSelectEnumerableIterator`2.MoveNext()\r\n   at System.Linq.Enumerable.SingleOrDefault[TSource](IEnumerable`1 source)\r\n   at Ninject.Planning.Targets.Target`1.GetValue(Type service, IContext parent)\r\n   at Ninject.Planning.Targets.Target`1.ResolveWithin(IContext parent)\r\n   at Ninject.Activation.Providers.StandardProvider.GetValue(IContext context, ITarget target)\r\n   at Ninject.Activation.Providers.StandardProvider.<>c__DisplayClass4.<Create>b__2(ITarget target)\r\n   at System.Linq.Enumerable.WhereSelectArrayIterator`2.MoveNext()\r\n   at System.Linq.Buffer`1..ctor(IEnumerable`1 source)\r\n   at System.Linq.Enumerable.ToArray[TSource](IEnumerable`1 source)\r\n"}

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