基于Docker的Django应用使用LibreOffice生成PDF权限问题排查

针对你遇到的普通用户执行LibreOffice转换命令失败、root执行正常的问题，核心是权限配置和LibreOffice用户目录权限问题，以下是具体解决步骤：

1. 修复输出目录的写入权限 #

你遇到的0xc10(Error Area:Io Class:Write Code:16)错误直接指向写入权限不足，先确保普通用户（django-user）对输出目录拥有读写权限：

# 在Dockerfile中添加，或容器内执行
RUN chown -R django-user:django-user /vol/logs
# 若需多用户访问，可设置目录权限（优先属主匹配）
RUN chmod -R 775 /vol/logs && chgrp -R django-user /vol/logs

2. 确保LibreOffice有可写的用户配置目录 #

LibreOffice在普通用户模式下需要读写用户目录下的配置文件，Alpine镜像默认可能未创建对应目录，需手动配置：

# 创建并授权LibreOffice配置目录
RUN mkdir -p /home/django-user/.config/libreoffice \
    && chown -R django-user:django-user /home/django-user/.config
# 确保普通用户HOME环境变量正确
ENV HOME=/home/django-user

容器终端临时测试时，先执行：

export HOME=/home/django-user
mkdir -p $HOME/.config/libreoffice
chown -R $USER:$USER $HOME/.config

3. 指定独立的锁文件目录（可选） #

LibreOffice运行时会生成锁文件，若默认目录存在权限冲突，可手动指定普通用户可写的锁目录：

# 创建锁目录并授权
RUN mkdir -p /home/django-user/libreoffice-locks \
    && chown django-user:django-user /home/django-user/libreoffice-locks

执行转换命令时添加--lockdir参数：

/usr/bin/soffice --headless --convert-to pdf --outdir /vol/logs/t/ \
    --lockdir /home/django-user/libreoffice-locks /vol/logs/word_sample_01.docx

4. 清理root用户残留的配置文件 #

若构建阶段用root执行过LibreOffice，可能在输出目录或临时目录生成root权限的文件，导致普通用户无法访问，需清理：

# 检查并删除root权限的残留文件
find /vol/logs -user root -delete

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