Azure WebApp Linux环境下KissLog访问/tmp路径权限报错如何解决

该错误核心是Azure Linux App Service环境的临时目录特性和KissLog默认存储路径配置不兼容导致的，报错中出现的Windows路径是KissLog库编译时的源代码路径，和运行环境无关，无需关注。

排查步骤 #

• 验证目录权限：通过Azure门户WebApp的SSH终端执行ls -ld /tmp/KissLog，查看目录所有者和权限位，确认应用运行身份（默认为低权限用户，ID通常为1000）是否有rwx权限
• 检查临时文件生命周期：Azure Linux App Service会自动清理/tmp目录下超过24小时未访问的文件，若KissLog持有已被清理文件的句柄，操作时就会抛出Bad file descriptor错误
• 确认部署模式：若WebApp开启了多实例横向扩展，不同实例的/tmp目录互相隔离，跨实例的文件操作也会触发权限错误
• 检查组件版本：确认当前使用的KissLog.NET版本是否包含Linux兼容修复，早于3.5.0的版本存在明确的跨平台路径处理缺陷

解决方案 #

• 优先修改KissLog默认存储路径：将临时文件存储位置从默认的/tmp/KissLog调整为Azure Linux App Service提供的持久化可写目录/home/KissLogTemp，该目录不会被系统自动清理，且默认对应用运行用户开放全部权限，配置示例：

// 程序启动时添加配置，如Program.cs/Startup.cs
KissLogConfiguration.Internal.UseLocalFileStorage(new LocalFileStorageOptions
{
    RootDirectory = "/home/KissLogTemp"
});

• 启动时主动初始化目录：避免路径不存在导致的首次访问报错，可在应用启动逻辑中添加如下代码：

var logTempDir = "/home/KissLogTemp";
if (!Directory.Exists(logTempDir))
{
    Directory.CreateDirectory(logTempDir);
    // 可选：开放目录权限避免多用户访问冲突
    Process.Start(new ProcessStartInfo("chmod", "755 " + logTempDir) { UseShellExecute = false })?.WaitForExit();
}

• 升级KissLog到最新稳定版：新版本已修复Linux环境下文件句柄自动释放、路径权限判断的相关问题，可大幅降低此类异常出现概率
• 调整临时文件清理策略：配置KissLog自动清理超过1小时未使用的临时日志文件，避免无效句柄长期残留

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