Title: Unhandled exceptions (zlib.error, EOFError, RuntimeError) during malicious/corrupt DOCX parsing · Issue #1561 · python-openxml/python-docx · GitHub
Open Graph Title: Unhandled exceptions (zlib.error, EOFError, RuntimeError) during malicious/corrupt DOCX parsing · Issue #1561 · python-openxml/python-docx
X Title: Unhandled exceptions (zlib.error, EOFError, RuntimeError) during malicious/corrupt DOCX parsing · Issue #1561 · python-openxml/python-docx
Description: Summary When parsing a .docx file using docx.Document(stream), the library relies heavily on Python's standard zipfile module to extract the internal XML files. If a user provides a malformed, corrupt, or unexpectedly modified ZIP struct...
Open Graph Description: Summary When parsing a .docx file using docx.Document(stream), the library relies heavily on Python's standard zipfile module to extract the internal XML files. If a user provides a malformed, corr...
X Description: Summary When parsing a .docx file using docx.Document(stream), the library relies heavily on Python's standard zipfile module to extract the internal XML files. If a user provides a malformed, ...
Opengraph URL: https://github.com/python-openxml/python-docx/issues/1561
X: @github
Domain: github.com
{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"Unhandled exceptions (zlib.error, EOFError, RuntimeError) during malicious/corrupt DOCX parsing","articleBody":"\n### Summary\n\nWhen parsing a `.docx` file using `docx.Document(stream)`, the library relies heavily on Python's standard `zipfile` module to extract the internal XML files.\n\nIf a user provides a malformed, corrupt, or unexpectedly modified ZIP structure, the underlying `zipfile` and `zlib` modules will throw native Python exceptions (`zlib.error`, `EOFError`, and `RuntimeError`). Because `python-docx` does not catch these specific exceptions during `PackageReader.from_file()`, they completely escape the library and cause an unhandled application crash.\n\nThese issues were discovered via fuzzing.\n\n---\n\n### Details & Tracebacks\n\n#### 1. `zlib.error` (Corrupted Compression Stream)\n\nIf the ZIP compression data is modified, `zlib` encounters an illegal compression distance.\n\n```text\nTraceback (most recent call last):\n File \"poc.py\", line 4, in \u003cmodule>\n doc = docx.Document(\"crash_zlib.docx\")\n ...\n File \"/usr/lib/python3.11/zipfile.py\", line 1027, in _read1\n data = self._decompressor.decompress(data, n)\nzlib.error: Error -3 while decompressing data: invalid distance too far back\n````\n\n---\n\n#### 2. `EOFError` (Truncated ZIP Data)\n\nIf the ZIP headers declare a larger size than the actual file stream contains, `zipfile` hits EOF unexpectedly.\n\n```text\nTraceback (most recent call last):\n File \"poc.py\", line 4, in \u003cmodule>\n doc = docx.Document(\"crash_eof.docx\")\n ...\n File \"/usr/lib/python3.11/zipfile.py\", line 1054, in _read2\n raise EOFError\nEOFError\n```\n\n---\n\n#### 3. `RuntimeError` (Unexpected Encryption Flag)\n\nIf a ZIP file flag is modified to indicate an internal XML file (e.g. `word/_rels/document.xml.rels`) is encrypted, `zipfile` throws a `RuntimeError` because no password was provided.\n\n```text\nTraceback (most recent call last):\n File \"poc.py\", in \u003cmodule>\n doc = docx.Document(\"crash_encrypted.docx\")\n File \"/usr/lib/python3.11/zipfile.py\", line 1598, in open\n raise RuntimeError(\"File 'word/_rels/document.xml.rels' is encrypted, password required for extraction\")\nRuntimeError: File 'word/_rels/document.xml.rels' is encrypted, password required for extraction\n```\n\n---\n\n### Suggested Remediation\n\nAny application parsing user-uploaded `.docx` files should catch a standard `PackageNotFoundError` or `BadZipFile` if the document is corrupt. The application developer should not have to manually catch `zlib.error` or `EOFError`.\n\nI suggest updating `docx.opc.pkgreader.PackageReader.from_file()` (or the underlying `phys_pkg.blob_for` method) to catch these native extraction exceptions and wrap them in a standard `python-docx` exception (such as `PackageNotFoundError` or a new `InvalidPackageError`).\n\n```python\nimport zipfile\nimport zlib\n\ntry:\n return self._zipf.read(pack_uri.membername)\nexcept (KeyError, zipfile.BadZipFile, zlib.error, EOFError, RuntimeError):\n raise PackageNotFoundError(\"Package is corrupt, truncated, or encrypted.\")\n```\n\n```","author":{"url":"https://github.com/MR-SS","@type":"Person","name":"MR-SS"},"datePublished":"2026-06-23T08:15:53Z","url":"https://github.com/python-openxml/python-docx/issues/1561"}
| react-profiling | 0 |
| react-import-map | react,react-dom,react-dom/client,react-dom/profiling,react-is,react/compiler-runtime,react/jsx-dev-runtime,react/jsx-runtime,scheduler@b8488ee2c322 |
| route-pattern | /_view_fragments/issues/show/:user_id/:repository/:id/issue_layout(.:format) |
| route-controller | voltron_issues_fragments |
| route-action | issue_layout |
| fetch-nonce | v2:6ac1e9dd-1b42-63d5-3b22-59df9d4ecde2 |
| current-catalog-service-hash | 81bb79d38c15960b92d99bca9288a9108c7a47b18f2423d0f6438c5b7bcd2114 |
| request-id | DC62:4676D:2185E8:2CE09C:6AFF638C |
| html-safe-nonce | 9be3df4e38a84e2a2ecaec86954b0d7d8fbe66e6c7d7aebe35875e990cf45556 |
| visitor-payload | eyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiJEQzYyOjQ2NzZEOjIxODVFODoyQ0UwOUM6NkFGRjYzOEMiLCJ2aXNpdG9yX2lkIjoiMTQ2ODE2Mzk3NTU1NTI3NzcwOCIsInJlZ2lvbl9lZGdlIjoiaWFkIiwicmVnaW9uX3JlbmRlciI6ImlhZCJ9 |
| visitor-hmac | 37c45e52ffaae77be390c94148b665615adf0035b5947be76d708b501b8b602b |
| hovercard-subject-tag | issue:4723933346 |
| github-keyboard-shortcuts | repository,issues,copilot |
| google-site-verification | Apib7-x98H0j5cPqHWwSMm6dNU4GmODRoqxLiDzdx9I |
| octolytics-url | https://collector.github.com/github/collect |
| analytics-location | / |
| fb:app_id | 1401488693436528 |
| apple-itunes-app | app-id=1477376905, app-argument=https://github.com/_view_fragments/issues/show/python-openxml/python-docx/1561/issue_layout |
| twitter:image | https://opengraph.githubassets.com/8dde86390c2b508af36878622b047ced54abf5e151f50d79c858b6f86e64f873/python-openxml/python-docx/issues/1561 |
| twitter:card | summary_large_image |
| og:image | https://opengraph.githubassets.com/8dde86390c2b508af36878622b047ced54abf5e151f50d79c858b6f86e64f873/python-openxml/python-docx/issues/1561 |
| og:image:alt | Summary When parsing a .docx file using docx.Document(stream), the library relies heavily on Python's standard zipfile module to extract the internal XML files. If a user provides a malformed, corr... |
| og:image:width | 1200 |
| og:image:height | 600 |
| og:site_name | GitHub |
| og:type | object |
| og:author:username | MR-SS |
| hostname | github.com |
| expected-hostname | github.com |
| None | 41b58589a1c4eda1e3c8904144a412b88ca4455f63ca2ad3629f2e9f3c3a1d12 |
| turbo-cache-control | no-preview |
| go-import | github.com/python-openxml/python-docx git https://github.com/python-openxml/python-docx.git |
| octolytics-dimension-user_id | 3403760 |
| octolytics-dimension-user_login | python-openxml |
| octolytics-dimension-repository_id | 13592924 |
| octolytics-dimension-repository_nwo | python-openxml/python-docx |
| octolytics-dimension-repository_public | true |
| octolytics-dimension-repository_is_fork | false |
| octolytics-dimension-repository_network_root_id | 13592924 |
| octolytics-dimension-repository_network_root_nwo | python-openxml/python-docx |
| turbo-body-classes | logged-out env-production page-responsive |
| disable-turbo | false |
| browser-stats-url | https://api.github.com/_private/browser/stats |
| browser-errors-url | https://api.github.com/_private/browser/errors |
| release | 8968d6d6acc65d74e4df332d23932dd3fd0502a4 |
| ui-target | full |
| theme-color | #1e2327 |
| color-scheme | light dark |
| react-app-name | issues |
Links:
Viewport: width=device-width