PrimeFaces 10文件上传报错：无法转换UploadedFilesWrapper为UploadedFile

错误根源 #

你开启了<p:fileUpload>的multiple="true"多选模式，但后台ManagedBean中用来接收文件的属性是单个UploadedFile类型。PrimeFaces在多选场景下会将所有上传文件封装为UploadedFilesWrapper对象，这和单个UploadedFile类型不兼容，因此抛出类型转换错误。

两种解决思路 #

思路1：保留多文件上传功能 #

把后台接收文件的属性改成List<UploadedFile>类型，同时修改上传逻辑遍历处理每个文件：

1. 修改ManagedBean的文件属性

// 替换原单个UploadedFile类型的属性
private List<UploadedFile> fileToUpload; // 注意和XHTML绑定的名称保持一致

// 生成getter和setter
public List<UploadedFile> getFileToUpload() {
    return fileToUpload;
}

public void setFileToUpload(List<UploadedFile> fileToUpload) {
    this.fileToUpload = fileToUpload;
}

2. 调整上传方法逻辑

public void uploadFileDone(){
    if (fileToUpload != null && !fileToUpload.isEmpty()) {
        for (UploadedFile singleFile : fileToUpload) {
            // 生成唯一文件名避免覆盖，可根据需求调整规则
            String uniqueFileName = "Activite_" + activite.getId() + "_" + System.currentTimeMillis() + ".pdf";
            this.upload(singleFile, uniqueFileName);
        }
    }
}

思路2：关闭多文件上传 #

如果不需要多选，直接移除<p:fileUpload>的multiple="true"属性：

<p:fileUpload uploadLabel="aa" cancelLabel="aa" value="#{managedBean.fileToUpload}" 
          mode="simple" skinSimple="true" />

同时确保后台fileToUpload属性是UploadedFile类型，并且uploadFileDone方法中使用的属性名和XHTML绑定的名称统一（当前代码中uploadFileDone用的是fileDetailActivite，需修改为fileToUpload）。

额外注意点 #

• 表单的enctype="multipart/form-data"必须保留，这是文件上传的必要配置。
• 后台属性名要和XHTML中value绑定的名称完全一致，否则无法获取到上传的文件。

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