[Wildfly&Jboss-Bug] Processing of multipart/form-data request failed. Connection terminated as request was larger than 10485760(UT005023/UT000020)

파일업로드 기능을 이용과정에서 발생하는 Jboss&Wildfly 오류에 대해서 기재한다.

해당 오류는 major한 사항으로 큰 이슈는 아니나, 개발적인 측면에서 기능적 오류로써 큰 부분이다. 

내용은 10MB를 초과한 파일을 업로드 시, 해당 오류가 발생하며 이를 해결하기 위해서는 WAS에서 설정을 적용 해주어야한다.

오류 발생원인으로 WAS에서 기본적으로 max-header-size와 max-post-size를 기본적으로 10MB를 정의하고 있기때문에 이와 같은 오류가 발생하며, 해결하기 위해서는 값을 조정해줄 필요가 있다.

 

#- 오류 내용

ERROR [io.undertow.request] (default task-2) UT005023: Exception handling request to URL: org.springframework.web.util.NestedServletException: Request processing failed; nested exception is org.springframework.web.multipart.MultipartException: Failed to parse multipart servlet request; nested exception is org.apache.commons.fileupload.FileUploadBase$IOFileUploadException: Processing of multipart/form-data request failed. UT000020: Connection terminated as request was larger than 10485760

 

10MB 초과 파일업로드 시, 발생하는 JBOSS(WAS)오류로그.

 

protocol-listener 내, max-header-size 기본값 내용(10MB).

 

protocol-listener 내, max-post-size 기본값 내용(10MB).

 

#- 각 Protocol listener 대상 설정정의(용량정의는 사용용도에 따라 설정)

[ajp-listener/max-post-size&max-header-size 정의(1GB)]
/subsystem=undertow/server=default-server/ajp-listener=ajp/:write-attribute(name=max-post-size,value=1073741824)
/subsystem=undertow/server=default-server/ajp-listener=ajp/:write-attribute(name=max-header-size,value=1073741824)

[각 protocol-listener max-post-size&max-header-size 확인]
/subsystem=undertow/server=default-server/http-listener=default:read-resource
/subsystem=undertow/server=default-server/https-listener=https:read-resource
/subsystem=undertow/server=default-server/ajp-listener=ajp:read-resource

 

파일 업로드 후, 정상적으로 DB 적재 로그내역 확인.

#- References

- [wildfly_docs] Admin_Guide(13)

- [wildscribe_github] WildFly protocol-listener(11)