EC2实例中MultipartFile转File遇权限拒绝问题排查与解决

问题根源分析 #

1. 路径选择错误：原代码直接用File(it)创建文件，默认会在执行java -jar命令的当前工作目录生成文件，但EC2上该目录通常不允许运行Jar的普通用户写入。
2. 无效的权限修改操作：在文件尚未创建时调用setWritable/setExecutable完全无效——这些方法仅能修改已存在文件的权限，文件不存在时操作必然失败。

修复步骤 #

1. 提前配置EC2目标目录权限 #

先确定你要上传文件的绝对路径目录（比如/home/ec2-user/upload-files），在EC2上执行以下命令创建并配置权限：

# 创建目标目录（递归创建父目录）
mkdir -p /home/ec2-user/upload-files
# 修改目录所有者为运行Jar的用户（假设用户是ec2-user）
sudo chown -R ec2-user:ec2-user /home/ec2-user/upload-files
# 配置目录权限（允许所有者读写执行，其他用户读执行）
sudo chmod -R 755 /home/ec2-user/upload-files

2. 修正文件转换代码 #

修改Kotlin代码，直接将文件写入指定目录，同时确保父目录存在：

private fun convertMultiPartFileToFile(multipartFile: MultipartFile, targetDir: String): File? {
    val fileName = multipartFile.originalFilename ?: return null
    // 构建指定目录下的目标文件对象
    val targetFile = File(targetDir, fileName)

    try {
        // 确保父目录存在，不存在则递归创建
        targetFile.parentFile?.let { parentDir ->
            if (!parentDir.exists()) {
                parentDir.mkdirs()
            }
        }

        // 写入文件内容
        FileOutputStream(targetFile).use { outputStream ->
            outputStream.write(multipartFile.bytes)
        }

        // 给已创建的文件设置权限（可选，根据业务需求调整）
        targetFile.setWritable(true, false)
        targetFile.setExecutable(true, false)

        return targetFile
    } catch (e: IOException) {
        throw RuntimeException("转换文件失败: ${e.message}", e)
    }
}

调用时传入目标目录的绝对路径即可：

val uploadedFile = convertMultiPartFileToFile(multipartFile, "/home/ec2-user/upload-files")

3. 权限问题排查验证 #

如果仍出现权限错误，按以下步骤排查：

• 查看运行Jar的用户：执行ps aux | grep java，找到Jar进程对应的用户。
• 验证目标目录权限：执行ls -ld /home/ec2-user/upload-files，确认目录所有者是运行Jar的用户，且权限包含读写权限。

关键注意事项 #

• 永远不要依赖当前工作目录存储文件，明确指定绝对路径能避免不同环境下的权限差异问题。
• 优先通过系统命令配置目录权限，不要在代码中尝试修改系统级目录的权限（代码层面的权限修改受限于JVM进程权限，往往无法生效）。

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