Maven Java项目中TXT文件写入遭遇访问权限拒绝问题求助

云上老周

2026-4-29

解决Maven Java Swing项目中FileWriter权限拒绝问题

你遇到的核心问题是写入了需要管理员权限的系统根目录，这也是为什么只有管理员运行才能正常工作的原因。下面给你几个可行的解决方案，以及针对Maven项目资源文件的正确处理方式：

问题根源梳理

你现在用/' + path得到的/logs.txt，在Windows系统里对应系统盘根目录（比如C:\logs.txt），在Linux/macOS里对应根目录/logs.txt——这些目录默认只有管理员/root用户才有写入权限，普通用户自然会被拒绝访问。

另外要注意：Maven项目中src/main/resources下的文件会被打包到Jar包内部，Jar包内的文件是只读的，不能直接写入，这也是你一开始需要修改IO逻辑的核心原因。

解决方案

1. 把文件写到普通用户有权限的路径

推荐几个安全的路径选择：

选项A：程序运行的当前目录

直接用相对路径logs.txt，文件会生成在你启动程序的命令行当前目录下，普通用户完全有权限读写：

// 去掉前面的斜杠，用相对路径即可
try {
    writer = new FileWriter("logs.txt", true);
    // ... 写入逻辑
} catch (IOException e) {
    // 给用户友好的错误提示，保留原始异常信息便于调试
    JOptionPane.showMessageDialog(null, "日志写入失败：" + e.getMessage(), "操作错误", JOptionPane.ERROR_MESSAGE);
}

选项B：用户主目录（最推荐）

用系统属性获取用户的主目录，这个路径每个用户都有完全控制权，不受运行目录影响：

import java.io.File;

// 获取用户主目录
String userHome = System.getProperty("user.home");
// 用File.separator适配不同系统的路径分隔符（Windows是\，Linux/macOS是/）
String logFilePath = userHome + File.separator + "shift-logs.txt";

try {
    // 确保父目录存在（虽然用户主目录肯定存在，但这是好习惯）
    new File(logFilePath).getParentFile().mkdirs();
    writer = new FileWriter(logFilePath, true);
} catch (IOException e) {
    JOptionPane.showMessageDialog(null, "无法写入日志文件：" + e.getMessage(), "操作错误", JOptionPane.ERROR_MESSAGE);
}

选项C：Maven项目的target目录（仅开发阶段）

如果只是在开发调试时使用，可以把文件写到Maven的target目录下，这个目录是编译生成的，普通用户有权限：

String projectDir = System.getProperty("user.dir"); // 获取项目根目录
String logFilePath = projectDir + File.separator + "target" + File.separator + "logs.txt";

// 先创建target目录（如果Maven还没自动生成）
new File(projectDir + File.separator + "target").mkdirs();

try {
    writer = new FileWriter(logFilePath, true);
} catch (IOException e) {
    // 处理异常
}

2. 正确处理Maven资源文件的读写

如果你原本想使用src/main/resources/logs.txt作为初始文件，要注意Jar包内的文件是只读的，正确的做法是：

程序启动时，把Jar内的logs.txt复制到用户可写的路径（比如用户主目录）
后续所有读写操作都针对复制后的文件

示例代码：

import java.io.*;
import javax.swing.JOptionPane;

public class GUI {
    public static void main(String[] args) {
        String userHome = System.getProperty("user.home");
        String destLogPath = userHome + File.separator + "shift-logs.txt";
        File destLogFile = new File(destLogPath);

        // 如果目标文件不存在，从Jar资源中复制初始文件
        if (!destLogFile.exists()) {
            try (InputStream resourceIn = GUI.class.getClassLoader().getResourceAsStream("logs.txt");
                 OutputStream fileOut = new FileOutputStream(destLogFile)) {
                if (resourceIn == null) {
                    // 如果资源文件不存在，创建空文件
                    destLogFile.createNewFile();
                    return;
                }
                // 复制文件内容
                byte[] buffer = new byte[1024];
                int bytesRead;
                while ((bytesRead = resourceIn.read(buffer)) != -1) {
                    fileOut.write(buffer, 0, bytesRead);
                }
            } catch (IOException e) {
                JOptionPane.showMessageDialog(null, "初始化日志文件失败：" + e.getMessage(), "操作错误", JOptionPane.ERROR_MESSAGE);
            }
        }

        // 之后就用destLogPath进行读写操作
        try (FileWriter writer = new FileWriter(destLogPath, true)) {
            writer.write("新的时间戳记录\n");
        } catch (IOException e) {
            JOptionPane.showMessageDialog(null, "写入日志失败：" + e.getMessage(), "操作错误", JOptionPane.ERROR_MESSAGE);
        }
    }
}

3. 优化错误处理逻辑

你提到把IOException转为IllegalArgumentException是为了统一捕获，但这种做法会掩盖原始错误的类型和上下文，不利于调试。建议直接处理IOException，或者包装成运行时异常并保留原始异常：

// 更合理的错误处理方式
try {
    writer = new FileWriter(logFilePath, true);
    // 写入操作
} catch (IOException e) {
    // 给用户友好提示
    JOptionPane.showMessageDialog(null, "日志写入失败，请检查文件权限：" + e.getMessage(), "操作失败", JOptionPane.ERROR_MESSAGE);
    // 或者抛出带原始异常的运行时异常，便于后续排查
    throw new RuntimeException("无法完成日志写入", e);
}

总结

只要避开系统根目录，把文件写到普通用户有权限的路径（比如用户主目录、程序运行目录），就能解决权限拒绝的问题。同时记住Maven资源文件是只读的，不能直接写入，需要复制到可写路径后再操作。

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

Maven Java项目中TXT文件写入遭遇访问权限拒绝问题求助

问题根源梳理 #

解决方案 #

1. 把文件写到普通用户有权限的路径 #