[Tomcat Wiki] Update of "FAQ/Troubleshooting_and_Diagnostics" by KonstantinKolinko

[Apache Wiki <wi...@apache.org>]

Dear Wiki user,

You have subscribed to a wiki page or wiki category on "Tomcat Wiki" for change notification.

The "FAQ/Troubleshooting_and_Diagnostics" page has been changed by KonstantinKolinko:
https://wiki.apache.org/tomcat/FAQ/Troubleshooting_and_Diagnostics?action=diff&rev1=17&rev2=18

Comment:
Add a section on RECYCLE_FACADES

  
    *  A good place for a breakpoint is `org.apache.catalina.connector.CoyoteAdapter.service()` method. That is the entry point from Tomcat connectors and into the Servlet engine. At that place your request has already been received and its processing starts.
  
+ == Troubleshooting Response State Problems ==
+ 
+ If you encounter problems that manifest themselves as accessing a request / response that is an inconsistent state. 
+ 
+ E.g. [[https://bz.apache.org/bugzilla/show_bug.cgi?id=61289|61289]], [[https://bz.apache.org/bugzilla/show_bug.cgi?id=58457|58457]]
+ 
+ The main suspect is your own web application keeping a reference to Request / Response objects outside of their life cycle.
+ 
+  1. Set the following [[http://tomcat.apache.org/tomcat-8.5-doc/config/systemprops.html#Security|system property]] in Tomcat configuration:
+ 
+     {{{org.apache.catalina.connector.RECYCLE_FACADES=true}}}
+ 
+  This flag instructs Tomcat to recycle facades to its internal objects, so that it is easier to spot illegal access when it happens, instead of waiting until internal state of referenced object becomes corrupted from concurrent access.
+ 
+  2. Read about [[FAQ/KnownIssues#ImageIOIssues|Java ImageIO]] issue.
+ 
  ----
  [[CategoryFAQ]]
  

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@tomcat.apache.org
For additional commands, e-mail: dev-help@tomcat.apache.org