gotchas: a gotcha is an unforeseen/unexpected/rarely known catch, limitation, dependency, bug, etc.

Sometimes one finds that something one expects to work one way does so, except when ...

Those "except when" type things - particularly when they are not documented, are what are often referred to as gotchas. In other words, you are caught unaware.